National Identity

Please note that when using your test key, Our test persona is John Doe and his National Identity Number is 10000000001. Hence all matching done with your test keys with details other than our Test Persona would simulate a failed identity matching.

post
Verify National Identity Number

https://vapi.verifyme.ng/v1/verifications/identities/nin/:ref
Use this endpoint to verify the identity of a person using their national identity number issued by NIMC.
Request
Response
Request
Path Parameters
ref
required
string
NIN number
Headers
Authorization
required
string
Authorization token
Body Parameters
dob
optional
string
Date of Birth
firstname
required
string
first name
lastname
required
string
last name
Response
200: OK
{
"status": "success",
"data": {
"fieldMatches":{
"firsname":false,
"lastname":false,
"dob":false
},
"nin": 1000000001,
"firstname": "John",
"lastname": "Doe",
"middlename": "Jane"
"phone": "08066676673",
"gender": "female"
"birthdate": "17/01/1988",
"photo": "Base64 Encoded"
}
}
404: Not Found
{
"code":"NOT_FOUND_ERROR",
"message":"NIN provided is not found. Please provide a valid nin"
}

Sample Request

Curl
Curl
curl --verbose
--header "Authorization: Bearer <token>"--data '{"firstname": "John","lastname": "Doe","dob": "14-04-1944"}'
--request "POST" "https://vapi.verifyme.ng/v1/identities/nin/<nin>"

post
Verify National ID with Registered Phone Number

https://vapi.verifyme.ng/v1/verifications/identities/nin_phone/:ref
Use this endpoint to verify the identity of a person using the phone number used in registering the national Identity with NIMC.
Request
Response
Request
Path Parameters
ref
required
string
NIMC Registered Phone number eg 0800000000
Headers
Authorization
required
string
Authorization token
Body Parameters
dob
optional
string
Date of Birth
firstname
required
string
first name
lastname
required
string
last name
Response
200: OK
{
"status": "success",
"data": {
"fieldMatches":{
"firsname":false,
"lastname":false,
"dob":false
},
"nin": 1000000001,
"firstname": "John",
"lastname": "Doe",
"middlename": "Jane"
"phone": "08066676673",
"gender": "female"
"birthdate": "17/01/1988",
"photo": "Base64 Encoded"
}
}
404: Not Found
{
"code":"NOT_FOUND_ERROR",
"message":"NIN provided is not found. Please provide a valid nin"
}

Sample Request

Curl
Curl
curl --verbose
--header "Authorization: Bearer <token>" --data '{"firstname": "John","lastname": "Doe","dob": "14-04-1944"}'
--request "POST" "https://vapi.verifyme.ng/v1/identities/nin_phone/<nin>"