Evaluation environment — TrustID is in a supervised test phase: every verification rail is simulated, and accounts, credits, API keys and history are rotated periodically without notice.
Binteca TrustID
Start

Developer Documentation

TrustID REST API Reference

Integrate real-time FICA, KYC, AVS banking, and biometric verifications with our certified HTTP REST API.

API Table of Contents

Host Environments

Local Dev:

http://localhost:3105

Production REST API:

https://trustid.binteca.com
Developer Sandbox: Pass "mode": "sandbox" or use a tid_test_... key to verify mock payloads without deducting live credits.

1. Authentication

Every request to protected endpoints must include your API key in either the Authorization: Bearer header or the X-API-Key header.

# Using Bearer token
Authorization: Bearer tid_live_4a82b9c7...

# Using direct API key header
X-API-Key: tid_live_4a82b9c7...

You can generate API keys directly in your TrustID Dashboard.

2. Verification Endpoints

SA ID (Home Affairs) Verification

POST /api/v1/verify/

Validates 13-digit South African ID number against Department of Home Affairs records.

curl -X POST https://trustid.binteca.com/api/v1/verify/ \
  -H "Authorization: Bearer tid_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "sa_id",
    "id_number": "8001015009087",
    "mode": "production"
  }'

Sample Response (200 OK):

{
  "verification_id": "ver_1725902189",
  "status": "succeeded",
  "result": {
    "report_type": "sa_id",
    "verified": true,
    "subject": "8001015009087",
    "provider_ref": "SIM-DHA-9087-PASS",
    "first_name": "Thabo",
    "last_name": "Mokoena",
    "dob": "1980-01-01",
    "gender": "Male",
    "citizen": "South African",
    "status": "ALIVE"
  }
}

Bank Account Verification Service (AVS)

POST /api/v1/verify/

Real-time BankservAfrica clearing validation for ABSA, FNB, Nedbank, Standard Bank, Capitec, and Investec.

curl -X POST https://trustid.binteca.com/api/v1/verify/ \
  -H "X-API-Key: tid_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "bank",
    "bank": "Standard Bank",
    "account_number": "1014928392"
  }'

Facial Liveness & 1:1 Match

POST /api/v1/verify/

Base64 encoded portrait selfie analysis against national photo repositories.

curl -X POST https://trustid.binteca.com/api/v1/verify/ \
  -H "X-API-Key: tid_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "face",
    "selfie_image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  }'

AML / PEP Sanction Screening

POST /api/v1/verify/

Screen individuals or corporations against global PEP, UN, OFAC, and FIC watchlists.

curl -X POST https://trustid.binteca.com/api/v1/verify/ \
  -H "X-API-Key: tid_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "aml",
    "full_name": "Thabo Mokoena"
  }'

3. Programmatic Key Management

Automate credential rotation and scoped sandbox provisioning.

GET /v1/api-keys List active keys
POST /v1/api-keys Mint new key {"label":"Prod Backend","sandbox":false}
DELETE /v1/api-keys/{id} Revoke key immediately

4. Usage & Quotas

Inspect remaining credits and monthly verification metrics.

curl https://trustid.binteca.com/v1/usage \
  -H "Authorization: Bearer tid_live_..."