Skip to main content

API Reference

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

Available endpoints​

EndpointDescription
GET /api/v1/public/kyc/verificationsSearch 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.

Authentication​

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.

Verification statuses​

StatusDescription
pendingThe user has not completed verification yet
processingImages are being processed by AI
approvedVerification approved
rejectedVerification rejected

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