API Reference

PhoneAdvanced

Validate a Phone Number and Retrieve Full KYC Details

The Phone Number Advanced verification endpoint goes beyond basic validation. It verifies the phone number and returns comprehensive KYC details, regardless of whether the phone number is linked to an NIN.

Main Features:

  • Provides detailed KYC data (e.g., name, photo, email, etc.) for the phone number, regardless of NIN linkage.

📘

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
}