Check KYC status

Retrieves the status of the latest KYC information submitted for the account and an array of matched account scores.

Each matched account score indicates how similar the KYC application data matches existing PII. A match score of 1.0 is a perfect match.

IMPORTANT: Accounts must have accepted KYC data on file in order to accrue a balance that may be paid out. If the KYC state is NODATA, DENY, or REVERIFY, direct the user to resubmit KYC data using the KYC flow.

Request
Security:
tilia_auth (read_kycs)
path Parameters
account_id
required
string <UUID4>

The account ID to retrieve.

Responses
200

Successfully retrieved KYC status.

400

Invalid input

401

Unauthorized access.

500

Service unavailable or server error.

get/v1/kyc/{account_id}
Request samples
curl -i -X GET \
  https://pii.tilia-inc.com/v1/kyc/:account_id \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
application/json
{
  • "status": "Success",
  • "message": null,
  • "codes": null,
  • "payload": {
    }
}