Phone Number lookup

POST/v1/nin/phone/lookup

Authorization

api-key

x-api-key<token>

In: header

Header Parameters

Idempotency-Key?string

Optional. Unique key identifying this request attempt for idempotency.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

phoneNumber*string

Phone Number to be verified

requestReason?string

Reason for the request

enterpriseId?string

Enterprise ID (defaults to platform config if omitted)

firstName?string

First name validation conditional trigger

lastName?string

Last name validation conditional trigger

dateOfBirth?string

Date of birth validation conditional trigger

base64Photo?string

Base64 photo for Face Match mode

Response Body

`application/json`

curl -X POST "https://example.com/v1/nin/phone/lookup" \  -H "Content-Type: application/json" \  -d '{    "phoneNumber": "08012345678"  }'

{  "success": true,  "statusCode": 200,  "message": "Request processed successfully",  "timestamp": "2025-10-20T16:30:00.000Z",  "data": {    "status": 200,    "verificationId": "txn_1234567890",    "charged": 100,    "biographicData": {},    "biometricData": {},    "validation": {}  },  "path": "/v1/nin/phone/lookup"}