Lookup Phone Number

This endpoint returns details of a phone number

📘
NOTE
There are two payload responses for this endpoint based on the details returned

Basic

Advanced

Phone Number Basic

Request

{{baseUrl}}api/v1/kyc/phone_number/basic?phone_number=081123456976

Header

Parameter	Type	Description
AppId	string	you would need to create an app to get your app ID
Authorization	string	public secret key e.g prod_sk_1T1eSavlZxy02OT3OWlvbxK4G

Query Parameters

Parameter	Type	Description
phone_number *	string	A valid phone number	required

Response Sample

{
    "entity": {
        "firstName": "JOHN",
        "MiddleName": "DOE",
        "lastName": "CHHUKWU",
        "gender": "Male",
        "nationality": "NGA",
        "dateOfBirth": "1990-05-16",
        "msisdn": "23481222222222"
    }
}

Phone Number Advanced

Request

{{baseUrl}}api/v1/kyc/phone_number?phone_number=081123456976

Query Parameters

Parameter	Type	Description
phone_number *	string	A valid phone numbe	required

Response Sample

{
    "entity": {
        "firstname": "JOHN",
        "middlename": "DOE",
        "surname": "CHHUKWU",
        "birthdate":"1960-12-12",
        "telephoneno": "08012345678",
        "photo": "BASE 64 IMAGE",
        "gender": "M",
        "customer": "9b2ac137-5360-4050-b412-4fa6728a31fb"
    }
}

Test Credentials

phone_number = 09011111111