DOJAH PARITY/api/v1/kyc/nuban/status

NUBAN KYC Status & Linked Identity Tier

Retrieve the CBN KYC compliance tier (Tier 1, 2, or 3) and linked national identity status associated with any Nigerian commercial or microfinance bank account.

COST25 NGX (₦25.00)
TARGET SLA< 180ms

Query Parameters

FieldTypeRequiredDescription
account_numberstringRequired10-digit NUBAN bank account number.
bank_codestringRequiredCBN bank code (e.g. 058 for GTBank, 011 for First Bank).

Example Request & Response (Dojah Parity)

cURL Request
curl -X GET "https://api.verixaid.com/api/v1/kyc/nuban/status?account_number=0123456789&bank_code=058" \
  -H "Authorization: vrx_live_9f83a8f1e2b4c6d8_a1b2c3d4..." \
  -H "AppId: app_6a7b8c9d0e1f" \
  -H "Content-Type: application/json"
HTTP 200 OK Response
{
  "status": "success",
  "entity": {
    "account_number": "0123456789",
    "account_name": "EMEKA CHIDERA OKAFOR",
    "bank_code": "058",
    "kyc_tier": "TIER_3",
    "bvn_linked": true,
    "nin_linked": true,
    "account_status": "ACTIVE"
  },
  "billed_amount": 25,
  "cached": false,
  "meta": {
    "request_id": "vx_req_kyc_status_2b1",
    "service": "nuban_status",
    "latency_ms": 138
  }
}