> For the complete documentation index, see [llms.txt](https://eyowo.gitbook.io/eyowo-developer-apis/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eyowo.gitbook.io/eyowo-developer-apis/api-resources/query-bvn.md).

# Queries

To perform a query, you must provide an `<X-App-Wallet-Access-Token>` Please, see the [authentication](/eyowo-developer-apis/api-resources/authentication.md) section on how to obtain `<X-App-Wallet-Access-Token>.`

## Query BVN

<mark style="color:blue;">`GET`</mark> `https://api.console.eyowo.com/v1/queries/bvn?bvn=`

The endpoint validates BVN(s) and returns the BVN holder's details, such as name, date of birth, etc. The service cost at standard BVN charges of N35(Naira) per query.&#x20;

#### Query Parameters

| Name | Type   | Description                   |
| ---- | ------ | ----------------------------- |
| bvn  | number | valid BVN number for querying |

#### Headers

| Name                      | Type   | Description                 |
| ------------------------- | ------ | --------------------------- |
| X-App-Key                 | string | `X-App-Key`                 |
| X-App-Wallet-Access-Token | string | `X-App-Wallet-Access-Token` |

{% tabs %}
{% tab title="200 " %}

```
{
    "success": true,
    "data": {
        "firstName": "DELE",
        "surname": "AHMED",
        "mobileNumber": "07088605494",
        "middleName": "CHINEDU",
        "dateOfBirth": "23-Feb-84",
        "responseMessage": "SUCCESSFUL"
    }
}
```

{% endtab %}
{% endtabs %}

## Query Data Products

<mark style="color:blue;">`GET`</mark> `https://api.console.eyowo.com/v1/queries/data/:telco`

The endpoint returns valid data products for the specified telco.

#### Query Parameters

| Name  | Type   | Description                          |
| ----- | ------ | ------------------------------------ |
| telco | number | `telcos [mtn, 9mobile, airtel, glo]` |

#### Headers

| Name                      | Type   | Description                 |
| ------------------------- | ------ | --------------------------- |
| X-App-Key                 | string | `X-App-Key`                 |
| X-App-Wallet-Access-Token | string | `X-App-Wallet-Access-Token` |

{% tabs %}
{% tab title="200 " %}

```
{
    "success": true,
    "data": {
        "products": [
            {
                "productId": "MTN-1-150MB",
                "denomination": 20000,
                "dataAmount": "150MB"
            },
            {
                "productId": "MTN-TEST-1-1GB",
                "denomination": 100000,
                "dataAmount": "1.0GB"
            },
            {
                "productId": "MTN-TEST-1-15GB",
                "denomination": 1000000,
                "dataAmount": "15.0GB"
            },
            {
                "productId": "EYOWO-TEST-1-100MB",
                "denomination": 10000,
                "dataAmount": "100MB"
            },
            {
                "productId": "MTN-1-60GB",
                "denomination": 5500000,
                "dataAmount": "60.0GB"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}