API Reference

Phone Number Advanced

Validate a bank verification number

With Phone Number Advanced Verification endpoint, you can rest assured that your customers’ phone numbers are accurate and legitimately belong to them. This endpoint uses the algorithms and database technology to verify phone numbers in real-time, ensuring that you only connect with legitimate users.

Main difference is it returns a Tracking ID and returns KYC details regardless of if the number is linked to NIN

📘

GET (LIVE)

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

📘

GET (TEST)

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

Parameter

KeyDescription
phoneNoPhone Number

Header (LIVE)

KeyDescription
x-api-keyYour Secret Key

Header (TEST)

KeyDescription
x-api-keyYour Public Key

Responses

{
    "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": "/9j/4AAQSkZJRgABAQEAYABgAAD/4QA...",
        "surname": "TEST",
        "telephoneNo": "09098674538",
        "title": "Ms",
        "trackingId": "TRACK987"
    },
    "error": null
}

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

{
    "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
}