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
201: Created
{
  "status": "success",
  "data": {
    "fieldMatches":{
      "firsname":false,
      "lastname":false,
      "dob":false
    },
    "nin": 1000000001,
    "firstname": "John",
    "lastname": "Doe",
    "middlename": "Jane"
    "phone": "08066676673",
    "gender": "female"
    "birthdate": "04-04-1944",
    "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 --location --request POST 'https://vapi.verifyme.ng/v1/verifications/identities/nin/10000000001' \
--header 'Authorization: Bearer <your secret key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "firstname":"John",
    "lastname":"Doe",
    "phone":"080000000000",
    "dob":"04-04-1944"
}'
​
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 --location --request POST 'https://vapi.verifyme.ng/v1/verifications/identities/nin_phone/10000000001' \
--header 'Authorization: Bearer <your secret key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "firstname":"John",
    "lastname":"Doe",
    "phone":"080000000000",
    "dob":"31-05-2000"
}'

Identity verifications - Previous

Identity Matching

Next - Identity verifications

Tax Identification Number

Last updated 1 month ago

National Identity

postVerify National Identity Number

Sample Request

postVerify National ID with Registered Phone Number

Sample Request

post
Verify National Identity Number

post
Verify National ID with Registered Phone Number