> For the complete documentation index, see [llms.txt](https://developer.myidentitypass.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.myidentitypass.com/products/data-verification/nigeria/phone-number/advance.md).

# Advance Phone Number

{% hint style="info" %}
TEST DATA

number: 08082838283
{% endhint %}

## Lookup phone number (Advance)

<mark style="color:green;">`POST`</mark> `https://api.myidentitypay.com/api/v2/biometrics/merchant/data/verification/phone_number/advance`

This endpoint allows you to lookup a phone number

#### Query Parameters

| Name                                     | Type   | Description  |
| ---------------------------------------- | ------ | ------------ |
| number<mark style="color:red;">\*</mark> | string | phone number |

#### Headers

| Name                                        | Type   | Description        |
| ------------------------------------------- | ------ | ------------------ |
| x-api-key<mark style="color:red;">\*</mark> | string | \<your secret key> |
| app-id<mark style="color:red;">\*</mark>    | String | \<your app id>     |

{% tabs %}
{% tab title="200 Data successfully retrieved." %}

```
{
    "status": true,
    "detail": "Verification Successful",
    "data": {
        "nin": "",
        "firstname": "",
        "middlename": "",
        "surname": "",
        "maidenname": "",
        "telephoneno": "",
        "state": "",
        "place": "",
        "title": "",
        "height": "",
        "email": "",
        "birthdate": "",
        "birthstate": "",
        "birthcountry": "",
        "centralID": "",
        "documentno": "",
        "educationallevel": "",
        "employmentstatus": "",
        "maritalstatus": "",
        "nok_firstname": "",
        "nok_middlename": "",
        "nok_address1": "",
        "nok_address2": "",
        "nok_lga": "",
        "nok_state": "",
        "nok_town": "",
        "nok_postalcode": "",
        "othername": "",
        "pfirstname": "",
        "photo": "Base 64 image",
        "pmiddlename": "",
        "psurname": "",
        "profession": "",
        "nspokenlang": "",
        "ospokenlang": "",
        "religion": "",
        "residence_town": "",
        "residence_lga": "",
        "residence_state": "",
        "residencestatus": "",
        "residence_AddressLine1": "",
        "residence_AddressLine2": "",
        "self_origin_lga": "",
        "self_origin_place": "",
        "self_origin_state": "",
        "signature": "base 64 image"
        "nationality": "",
        "gender": "m",
        "trackingId": ""
    },
    "verification": {
        "status": "",
        "reference": ""
    }
}
```

{% endtab %}
{% endtabs %}
