> ## Documentation Index
> Fetch the complete documentation index at: https://sigma-docs.pastelhq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BVN Search

> Look up individual identity details using a Bank Verification Number (BVN).

### What is BVN?

The Bank Verification Number (BVN) is a unique 11-digit identifier issued by the Central Bank of Nigeria (CBN) to every bank account holder in Nigeria. It links an individual's biometric data and personal information across all Nigerian banks.

### How it Works

Send a POST request to `/api/v1/kyc/bvn` with the individual's BVN in the request body. The API returns verified biographical data, contact information, and a base64-encoded passport photo from the BVN registry.

```bash theme={null}
curl --location 'https://sigmacdd.sabipay.com/api/v1/kyc/bvn' \
--header 'apiKey: {{apiKey}}' \
--header 'apiSecret: {{apiSecret}}' \
--header 'Content-Type: application/json' \
--data '{
    "idNumber": "22241887099"
}'
```

### Request

| Field      | Type   | Required | Description                           |
| ---------- | ------ | -------- | ------------------------------------- |
| `idNumber` | string | Yes      | The 11-digit Bank Verification Number |

### Response Fields

A successful response returns the following data:

| Field              | Type   | Description                    |
| ------------------ | ------ | ------------------------------ |
| `idNumber`         | string | The BVN                        |
| `firstName`        | string | First name                     |
| `lastName`         | string | Last name                      |
| `middleName`       | string | Middle name                    |
| `dateOfBirth`      | string | Date of birth (YYYY-MM-DD)     |
| `gender`           | string | Gender                         |
| `phoneNumber`      | string | Primary phone number           |
| `phoneNumber2`     | string | Secondary phone number         |
| `nationality`      | string | Nationality                    |
| `address`          | string | Residential address            |
| `photo`            | string | Base64-encoded passport photo  |
| `email`            | string | Email address                  |
| `lgaOfOrigin`      | string | LGA of origin                  |
| `lgaOfResidence`   | string | LGA of residence               |
| `stateOfOrigin`    | string | State of origin                |
| `stateOfResidence` | string | State of residence             |
| `maritalStatus`    | string | Marital status                 |
| `enrollmentBank`   | string | Bank where BVN was enrolled    |
| `enrollmentBranch` | string | Branch where BVN was enrolled  |
| `watchListed`      | string | Whether the BVN is watchlisted |
| `linkedNin`        | string | Linked NIN                     |

<Note>
  Fields may return `null` if the data is not available in the registry. For the full API specification, see the [BVN Search API reference](/api-reference/kyc/endpoint/bvn-search).
</Note>