API Reference

Trusty's public API for querying verifications and receiving results.

Available endpoints

Endpoint	Description
`GET /api/v1/public/kyc/verifications`	Search and list verifications
`POST (webhook)`	Trusty sends results to your endpoint

The widget handles capture and processing internally. You only receive the result via webhook and can query history via API.

Use your webhook_secret as a Bearer token on all requests:

Authorization: Bearer TR_WHS_xxx

All queries are scoped to your account — you cannot see other clients' verifications.

Status	Description
`pending`	The user has not completed verification yet
`processing`	Images are being processed by AI
`approved`	Verification approved
`rejected`	Verification rejected

See Lookup API for usage details and Webhooks for the payload structure.