Get a customer's full verification history

GET 
/v2/kyc/timeline

Returns every KYC verification on record for a customer, newest first, each with its linked certificate if one was issued — including a revoked certificate, shown with its revoke reason rather than silently dropped from the list.

A single certificate proves an address was checked once. This endpoint is what turns repeated verification (e.g. periodic re-verification from /verify/schedule) into a pattern a lender can actually assess: has this customer verified at the same address consistently, or has it moved.

Request

Responses

200

Verification timeline

400

Missing customer_id

403

Banking Suite (collections tracking, portfolio risk, re-verification scheduling, the audit-log endpoint) is provisioned per institution, not self-serve — an account gets access via an admin-issued grant, not simply by holding an API key. Also returned when the account has an IP allowlist configured and the request's source IP isn't on it.

404

No verifications found for customer