Skip to main content
POST
/
api
/
v4
/
kyb
/
{applicant_id}
/
verify-document
Verify corporate document
curl --request POST \
  --url https://api.dataspike.io/api/v4/kyb/{applicant_id}/verify-document \
  --header 'Content-Type: application/json' \
  --header 'ds-api-token: <api-key>' \
  --data '
{
  "documents": [
    {
      "doc_path": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
      "document_type": "KybCertificateOfIncorporation"
    }
  ],
  "user_provided_data": {
    "shareholders": [
      {
        "name": "John Doe",
        "first_name": "John",
        "last_name": "Doe",
        "nationality": "US"
      }
    ]
  }
}
'
{
  "request_id": "019c9e79-4d64-73e1-9f30-5374f0f57975",
  "status": "initial"
}

Authorizations

ds-api-token
string
header
required

Path Parameters

applicant_id
string<uuid>
required

The applicant ID to associate with this verification

Example:

"01827ed4-c928-7a3c-9a30-7ab7cc169d11"

Body

application/json
documents
object[]
required

List of documents to verify

user_provided_data
object

Response

Request accepted, verification in progress

request_id
string<uuid>

Unique identifier for this verification request. Use to poll for results.

Example:

"019c9e79-4d64-73e1-9f30-5374f0f57975"

status
enum<string>

Always initial on submission

Available options:
initial
Example:

"initial"