> 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/staging/api-resources/query-bvn.md).

# Query BVN

This 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 on the user's app wallet.

To query BVN(s), you must provide an `<X-App-Wallet-Access-Token>` Please, see the [authentication](/eyowo-developer-apis/staging/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.staging-api.eyowo.com/v1/queries/bvn?bvn=`

#### 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 %}