KYC Integration | Developer Docs

Please wait

KYC Integration

Individual identity verification — documents, MRZ/OCR, biometric face match, AML, and risk scoring in a single call.

Know Your Customer verification covers document authenticity, MRZ checksum validation, biometric face match, AML screening, and risk scoring — all returned in a single API call.

Supported document types

Passport

MRZ extraction + biometric chip read (where available). Highest confidence level.

Highest confidence

National ID

Front + back capture.

Front and back

Driving Licence

UK DVLA, EU, and international formats supported.

UK & international

Proof of Address

Utility bill, bank statement. OCR-extracted and matched.

Address verification

Node.js — Full KYC call

NODE.JS

// No SDK package is published: this is the REST call, with Node 18+ fetch.
const res = await fetch('https://api.trustverify.co.uk/api/v1/kyc/verify', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.TRUSTVERIFY_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    documentType:       'driving_licence',
    documentImageFront: frontBase64,
    documentImageBack:  backBase64,
    selfieImage:        selfieBase64,
    checks: {
      amlScreening:   true,   // the only two keys the endpoint reads
      dataSpikeCheck: true,
    },
    generateReport: true,   // returns RPT-001 PDF URL
    metadata: {
      firstName: 'Jane',    // a name is required while amlScreening is on
      lastName:  'Smith',
      reference: 'user_12345',
    },
  }),
});
const result = await res.json();

Data sources and latency

Check	Source	Latency
Document authenticity	Document checks (MRZ, font, tamper)	Seconds
Biometric face match	Face match service	Seconds
Liveness detection	Not yet available (planned)	—
AML screening	Sanctions, PEP and watchlist screening	Seconds
Address verification	OCR cross-reference	Seconds