Verify corporate document

Submit corporate documents (certificate of incorporation, shareholder certificate, etc.) for KYB verification. Optionally provide shareholder data to validate against extracted document information.

The request is processed asynchronously. Poll GET /api/v4/kyb/result/{request_id} for the result.

POST /api/v4/kyb/{applicant_id}/verify-document

Verify corporate document

cURL

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"
    }
  ],
  "user_provided_data": {
    "shareholders": [
      {
        "name": "John Doe",
        "first_name": "John",
        "last_name": "Doe",
        "nationality": "US"
      }
    ]
  }
}
'

202

{
  "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

Show child attributes

user_provided_data · object

Show child attributes

Response

202

application/json

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"