PhoneNIN

Validate a Phone Number Linked to NIN

The Phone Number NIN verification endpoint allows you to verify if a phone number is linked to a National Identification Number (NIN). If the phone number is indeed linked to an NIN, KYC details will be provided.

Main Features:

• Returns KYC details only if the phone number is linked to a valid National Identification Number.

📘

GET (LIVE)

{{URL}}/dikript/verification/api/v1/getphonenumber

📘

GET (TEST)

{{URL}}/dikript/test/api/v1/getphonenumber

Parameter

Key	Description
phoneNo	Phone Number

Header (LIVE)

Key	Description
x-api-key	Your Secret Key

Header (TEST)

Key	Description
x-api-key	Your Public Key

Responses

jsc

{
    "status": true,
    "message": "Successful",
    "code": "200",
    "apiVersion": "v1",
    "transactionRef": "N202401101330172230",
    "data": {
        "firstName": "TEST",
        "birthDate": "1088-12-12",
        "employmentStatus": "",
        "gender": "",
        "middleName": "TEST",
        "nin": "98759082158",
        "email": "",
        "otherName": "TEST",
        "photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBD7D/AKtfpUvaiivPZ6TGtTk60UUCP//Z",
        "residenceAdressLine1": "",
        "residenceLga": "",
        "residenceState": "",
        "selfOriginState": "",
        "signature": "",
        "surname": "TEST",
        "telephoneNo": "09098674538",
        "title": "",
        "trackingId": ""
    },
    "error": null
}

JSON

{
  	"status": false,
    "message": "Unsuccessful",
    "code": "400",
    "apiVersion": "v1",
    "transactionRef": "N202401101345487388",
    "data": "",
    "error": {
        "code": 400,
        "message": null
    }
}

JSON

{
    "status": true,
    "message": "phoneNumber not found",
    "code": "200",
    "apiVersion": "v1",
    "transactionRef": "N202401101330172230",
    "data": {
        "firstName": "",
        "birthDate": "",
        "employmentStatus": "",
        "gender": "",
        "middleName": "",
        "nin": "",
        "email": "",
        "otherName": "",
        "photo": "",
        "residenceAdressLine1": "",
        "residenceLga": "",
        "residenceState": "",
        "selfOriginState": "",
        "signature": "",
        "surname": "",
        "telephoneNo": "",
        "title": "",
        "trackingId": ""
    },
    "error": null
}