Quick Start

From sign-up to your first Truztcube verification in a few minutes — get an API key, make a NIN lookup, read the result, then go live.

Truztcube verifies Nigerian identities through one API. This guide takes you from a new account to your first successful verification.

Create your account

Sign up and sign in to the dashboard. Login is email + password with an OTP step (POST /v1/auth/login → POST /v1/auth/confirm-login). See Authentication.

Generate a test API key

Create a key with POST /v1/api-keys (type: "test"), or use the dashboard. Copy the sk_test_… secret — it's shown once. Test keys run against the sandbox with no wallet spend.

Make your first verification

Call an endpoint with your key in the x-api-key header. A NIN raw lookup:

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"
  }'

requestReason records why you ran the check (see the valid values at GET /v1/nin/request-reasons).

Every verification returns a Truztcube verification ID, a status, and the verified fields your access level permits. Fields the register returns empty are omitted, not null-filled. Branch on the status — see Errors & Statuses.

Fund your wallet and go live

Swap the test key for a live key (sk_live_…), fund your wallet (POST /v1/payments/initialize → complete payment → GET /v1/payments/verify/{reference}), and you're verifying against the real registers. Live verifications debit your wallet only on a billable result.

Every call follows the same shape: authenticate → submit an identifier → get a verified result → it's debited from your wallet (live only, on success).

What's next

Authentication — API keys, headers, test vs live.
ID Verification — all NIN and BVN lookup modes.
API Reference — the full endpoint catalogue.