Enhanced phone lookup

Resolve a phone number (MSISDN) to a NIN identity record via TruztFix resolution + NIMC lookup. Requires an active Enhanced Phone Lookup subscription. Primary path: TruztFix resolves MSISDN→NIN, then NIMC raw lookup. Fallback path: NIMC phone-number lookup when TruztFix cannot resolve the MSISDN.

POST/v1/nin/phone-enhanced/lookup

Authorization

api-key

x-api-key<token>

In: header

Header Parameters

Idempotency-Key?string

Optional. Unique key for idempotent replay.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

phoneNumber*string

Phone number in any of: international (2348012345678), local (08012345678), or E.164 (+2348012345678). Automatically normalised to 234-prefix format before processing.

requestReason?string

Reason for the request

enterpriseId?string

Enterprise ID (defaults to platform config if omitted)

Response Body

`application/json`

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

{  "success": true,  "statusCode": 200,  "message": "Request processed successfully",  "timestamp": "2025-10-20T16:30:00.000Z",  "path": "/v1/auth/register",  "data": {    "status": 200,    "verificationId": "01962a5e-1234-7abc-8def-000000000000",    "charged": 10000,    "nin": "12345678901",    "biographicData": {},    "biometricData": {},    "validation": {},    "resolutionPath": "primary"  }}