DOJAH PARITY/api/v1/kyc/phone_number

Phone Number Intelligence

Resolve the verified subscriber identity and carrier intelligence behind any Nigerian mobile phone number (MTN, Airtel, Glo, 9mobile) via upstream carrier KYC registries.

BASIC PHONE85 NGX (₦85.00)
FULL INTELLIGENCE120 NGX (₦120.00)
SMART CACHE HIT30 NGX (₦30.00)
TARGET SLA< 180ms

Available Endpoints

1. Basic Phone LookupGET /api/v1/kyc/phone_number/basic?phone_number=...

Returns subscriber first name, surname, and registered status.

2. Full Carrier IntelligenceGET /api/v1/kyc/phone_number?phone_number=...

Adds date of birth, gender, address, carrier network, and portrait.

Query Parameters

FieldTypeRequiredDescription
phone_numberstringRequiredValid 11-digit or E.164 Nigerian phone number (e.g. 08012345678 or +2348012345678).

Example Request & Response (Dojah Parity)

cURL Request
curl -X GET "https://api.verixaid.com/api/v1/kyc/phone_number?phone_number=08012345678" \
  -H "Authorization: vrx_live_9f83a8f1e2b4c6d8_a1b2c3d4..." \
  -H "AppId: app_6a7b8c9d0e1f" \
  -H "Content-Type: application/json"
HTTP 200 OK Response
{
  "status": "success",
  "entity": {
    "phone_number": "08012345678",
    "first_name": "EMEKA",
    "last_name": "OKAFOR",
    "date_of_birth": "1994-08-22",
    "gender": "Male",
    "network": "MTN",
    "status": "Active"
  },
  "billed_amount": 120,
  "cached": false,
  "meta": {
    "request_id": "vx_req_7d82b01a",
    "service": "phone_advance",
    "latency_ms": 172
  }
}