Please wait
From API key to your first verification in five minutes.
Every TrustVerify integration starts with an API key. Sign up, copy your test key from /dashboard/api-keys, and you're ready to verify your first user.
Create your account & get an API key
Go to Dashboard → API Keys and create a Test key to develop safely — sandbox requests run against fixtures and are never billed.
Make your first verification call
Use the curl snippet below to run a KYC check against the sandbox. A test key's call is checked the way a live one is: both images, and the person's name in metadata while AML screening is on (the default). Replace the base64 placeholders with real document and selfie images.
Check the response & iterate
The API returns a structured JSON result with a status, checkId, and a downloadable PDF report. Wire this into your onboarding flow.
Switch to Live keys when ready
There is no test/live toggle: keys are immutable. On a paid plan, create a Live key, update your environment variable, then revoke the old one.
curl -X POST https://api.trustverify.co.uk/api/v1/kyc/verify \
-H "Authorization: Bearer tv_test_sk_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"documentType": "passport",
"documentImage": "<base64-encoded-image>",
"selfieImage": "<base64-encoded-selfie>",
"metadata": {
"firstName": "Jane",
"lastName": "Smith",
"reference": "user_12345",
"source": "web-onboarding"
}
}'{
"checkId": "chk_01J8KX9QMN23PQRST",
"status": "passed",
"score": 0.97,
"riskLevel": "low",
"reportUrl": "https://api.trustverify.co.uk/reports/RPT-001/chk_01J8KX9QMN23PQRST.pdf",
"completedAt": "2026-06-17T20:15:00Z"
}Test keys (tv_test_sk_…) return synthetic results and never bill your account. Live keys (tv_live_sk_…) process real verifications against your plan's quota.