Retrieve an identity check

GET

/api/kyc/checks/individual/:id

GET

/api/kyc/checks/individual/:id

curl https://sandbox-api.toden.co/api/kyc/checks/individual/id \
     -H "Authorization: Bearer <apiKey>"

{
  "check": {
    "id": "cmt8s0a4p0001qw9k2m7f3xyz",
    "status": "verified",
    "country": "NG",
    "initiatedVia": "api",
    "createdAt": "2026-09-12T10:00:00.000Z",
    "idType": "bvn",
    "reasonCode": null,
    "verificationMethod": "sandbox",
    "chargedAmount": null,
    "completedAt": "2026-09-12T10:00:02.000Z",
    "reason": null,
    "chargedBreakdown": {},
    "idNumber": "00000000001",
    "submittedData": {
      "dateOfBirth": "1990-01-15",
      "firstName": "Ada",
      "lastName": "Example"
    },
    "result": {
      "firstName": "ADA",
      "lastName": "EXAMPLE",
      "middleName": null,
      "dateOfBirth": "1990-01-15",
      "gender": "f",
      "dataMatch": true,
      "facialMatch": null,
      "facialMatchSkipped": null
    },
    "govRecord": null,
    "media": null
  }
}

Returns one identity check in full: what you submitted, the outcome, the details the check established and links to its photos. Poll this until status leaves pending.

Error codes

`error`	Status	Meaning
`not_found`	404	No identity check with that id, or it was deleted.
`secret_key_required`	403	A publishable key was used. This endpoint accepts secret keys only.
`environment_mismatch`	403	The key belongs to an environment this deployment does not serve.
`ip_not_allowed`	403	The key has an IP allowlist and the calling address is not on it.
`organization_suspended`	403	The organisation is suspended. The response carries `reason` and `suspendedAt`.
`business_not_approved`	403	A live key was used before the business was approved for production.

A missing or unknown key answers 401, where error is a short sentence rather than a code.

Requires a secret (sk_) key. A publishable key receives 403 secret_key_required.

Authentication

AuthorizationBearer

Send the API key as a Bearer token. Each operation states whether a publishable key is enough or a secret key is required.

Path parameters

idstringRequired

The check id, as returned by the submit as verificationId.

Response

The identity check.

checkobject

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error