API reference

Every public endpoint, generated from the published OpenAPI description, with samples in eight languages.

Base URL https://api.trustverify.co.uk/api/v1. Send your key as Authorization: Bearer (see Authentication). This reference is built from openapi.json.

Authentication#

Validate keys and exchange them for short-lived tokens.

POST/api/v1/tokenExchange an API key for a short-lived Bearer access token
GET/api/v1/validate-keyValidate the presented API key and return plan/usage info

KYC#

Identity checks: ID document and selfie. We cover liveness checks.

POST/api/v1/kyc/verifyRun a full KYC verification via API key

KYB#

UK company checks against the UK company register.

POST/api/v1/kyb/verifyVerify a UK business against the UK company register

AML#

Sanctions and PEP screening, and ongoing monitoring.

POST/api/v1/aml/screenScreen an individual or business for AML/sanctions
GET/api/v1/aml/monitorList monitored subjects
POST/api/v1/aml/monitorEnrol a subject in ongoing AML monitoring
GET/api/v1/aml/monitor/{monitorId}Read one monitored subject and its match history
DELETE/api/v1/aml/monitor/{monitorId}Cancel monitoring for a subject

Checks#

Read check results.

GET/api/v1/checks/{checkId}Retrieve a check result by ID

Workflows#

Run a saved workflow.

POST/api/v1/workflows/runTrigger a workflow by ID

Reports#

Compliance reports and evidence bundles.

GET/api/v1/reports/{reportType}/{checkId}Report availability metadata / PDF download for a check
POST/api/v1/reports/rpt-016Register a regulatory evidence bundle (RPT-016) for a check
GET/api/v1/bundles/{bundleId}Evidence bundle readiness metadata / ZIP download

Webhooks#

GET/api/v1/webhooksList registered webhook endpoints
POST/api/v1/webhooksRegister a webhook endpoint
PATCH/api/v1/webhooks/{id}Update a webhook endpoint
DELETE/api/v1/webhooks/{id}Delete a webhook endpoint