Check KYC status

Retrieves the state of the latest KYC information submitted for the account. Accounts must have valid KYC data on file (KYC state must return a value of ACCEPT) in order to request and receive payouts.

If KYC state is NODATA, DENY, or REVERIFY, you can direct your 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": {
    }
}