Developer Documentation

TrustID REST API Reference

Integrate real-time FICA, KYC, and biometric verifications with a single HTTP POST request.

API Quick Links

1. Authentication
2. SA ID Verification
3. Bank Account AVS
4. Face Biometrics
5. AML / PEP Screening

Base URLs

Local Dev:

http://localhost:3105

Production API:

https://trustid.binteca.com

Provider note: responses come from a built-in simulated provider (references are prefixed SIM-). Certified data rails are connected per deployment before production reliance.

cURL Example: Verify SA ID

Send an ID verification request with your API key.

curl -X POST http://localhost:3105/api/v1/verify/ \
  -H "Authorization: Bearer tid_live_demo_key_4242" \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "sa_id",
    "id_number": "8001015009087",
    "mode": "sandbox"
  }'

Node.js / TypeScript Example

const response = await fetch('http://localhost:3105/api/v1/verify/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer tid_live_demo_key_4242',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    reportType: 'bank',
    account_number: '1014928392',
    bank: 'Standard Bank'
  })
});

const result = await response.json();
console.log(result.result.account_status); // "OPEN"