Phone

When you do not have the NIN but you do have the holder’s phone number, use this mode to retrieve their record.

POST/verify-nin/phone

Request

Field	Type	Required	Notes
phone_no	string	✅	11 digits, must begin with 0 (e.g. 08012345678)
reason	string	✅	A key from /nimc-reasons

curl

curl -X POST https://api.randaverify.com/verify-nin/phone \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_no": "08012345678",
    "reason": "corporate"
  }'

Python

resp = requests.post(
    "https://api.randaverify.com/verify-nin/phone",
    headers={"Authorization": f"Bearer {token}"},
    json={"phone_no": "08012345678", "reason": "corporate"},
    timeout=30,
)

Response (200)

{
  "data": {
    "reference_id": "REF-AABB1122CCDD",
    "transaction_id": "...",
    "fname": "UCHECHI",
    "mname": "VIVIAN",
    "lname": "IGWEDINMA",
    "dob": "22-10-1988",
    "gender": "Female",
    "phone": "09052129949",
    "residenceAdress": "NO 26 MARIA OKOR STREET OFF AILEGUN ROAD",
    "stateOfOrigin": "Lagos",
    "lgaOfOrigin": "Lagos Mainland",
    "image": "<base64 jpeg>"
  }
}

What phone verification does not return

For privacy, NIMC’s phone-verification endpoint does not return:

• The NIN itself — phone alone cannot be used to enumerate NINs.
• Residence Town / LGA / State — only the address line is returned.
• Origin Town — only the state and LGA of origin.

If you need any of those fields, fall back to a standard NIN verification once you have the NIN through another channel.

Failure modes

Status	When	Recover by
400	phone_no not 11 digits / not starting with 0; or invalid reason	Fix the input.
402	Org wallet empty	Top up.
404	NIMC has no record matching the phone	Try a different phone or fall back to demography.