Integration Methods

How to integrate Truztcube — the REST API today, with hosted flows, widgets and SDKs on the roadmap.

REST API

The primary integration: authenticated JSON endpoints over HTTPS with a consistent request/response envelope across every verification type. Authenticate with the x-api-key header (Authentication).

Base URL

https://api.truztcube.com/v1

A verification call

curl -X POST https://api.truztcube.com/v1/nin/raw/lookup \
  -H "x-api-key: sk_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "nin": "00000000000", "requestReason": "KYC" }'

Discover what you can call

GET /v1/lists/verification-types — the verification types available to you.
GET /v1/services — the services on your account.
Full endpoint catalogue: the API Reference.

Idempotency

Pass an Idempotency-Key header so a retried request never runs twice or double-charges. See Errors & Statuses.

Hosted verification URL

Roadmap — a Truztcube-hosted page to complete a verification without capturing identity data yourself.

Embeddable widgets & SDKs

Roadmap — a drop-in JavaScript widget and native mobile SDKs. See SDKs.

Authentication
API Reference