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.
/v1/nin/unique-phone/lookupAuthorization
api-key In: header
Header Parameters
Required for live keys. A retry with the same key returns the original result and is billed once.
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/unique-phone/lookup" \ -H "X-Correlation-ID: string" \ -H "Content-Type: application/json" \ -d '{ "phoneNumber": "08031234567" }'{ "success": true, "statusCode": 200, "message": "Request processed successfully", "timestamp": "2025-10-20T16:30:00.000Z", "path": "/v1/auth/register", "data": {}}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.
BVN Basic Lookup
Verify a BVN number and retrieve basic identity data (name, date of birth, gender, phone). Requires a valid Idempotency-Key header for live-mode API keys to prevent duplicate charges.