DocsQuickstart

Quickstart

From API key to your first verification in five minutes.

5 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 the Developer Console → API Keys. Create a Test key to develop safely — no real data is processed.

Make your first verification call

Use the curl snippet below to run a KYC check against the sandbox. 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

In the Console, toggle from Test → Live. Update your environment variable — everything else stays the same.

cURL — KYC Verify

CURL

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": {
      "reference": "user_12345",
      "source":    "web-onboarding"
    }
  }'

Example Response

JSON

{
  "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.