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.
/v1/nin/phone-enhanced/lookupAuthorization
api-key In: header
Header Parameters
Optional. Unique key for idempotent replay.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/nin/phone-enhanced/lookup" \ -H "Content-Type: application/json" \ -d '{ "phoneNumber": "2348012345678", "enterpriseId": "ENT1A2B3C4D5E6F" }'{ "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" }}Phone Number lookup
Validate NIN using the phone number associated with the NIN
Unique Phone Verification — resolve a phone number to an identity
Resolves a Nigerian mobile number to the identity behind it. Requires an active Unique Phone Verification subscription — this is a separate billable service from Enhanced Phone Lookup, not a tier of it. A result already held from an earlier verification is served from storage and charged at the same price; `source` tells you which you received, and `verifiedAt` is the age of the underlying provider lookup so you can judge freshness yourself. Unlike Enhanced Phone Lookup there is no NIMC fallback: if the number cannot be resolved, the request is refunded rather than retried elsewhere.