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

# Lookup NUBAN

> Resolve a Nigerian bank account number (NUBAN) to account name and bank details. Used to confirm payee before transfers and for KYC.

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/kyc/nuban
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                  |

### Query parameters

| Parameter          | Type    | Description         | Required |
| ------------------ | ------- | ------------------- | -------- |
| account\_number \* | string  | Bank account number | required |
| bank\_code \*      | integer | Bank Code           | required |

<Note>
  The bank codes can be gotten from this [endpoint](/docs/general/service/fetch-banks).
</Note>

### Sample response

```json Response theme={null}
{
  "entity": {
    "account_currency": "566",
    "account_name": "JOHN DOE MUSA",
    "account_number": "3046***407",
    "account_type": "10",
    "address_1": ".",
    "address_2": "",
    "city": "LAGOS",
    "country_code": "",
    "country_of_birth": "",
    "country_of_issue": "",
    "dob": "10/06/1982",
    "expiry_date": "",
    "first_name": "John",
    "identity_number": "222******556",
    "identity_type": "BVN",
    "last_name": "Musa",
    "nationality": "",
    "other_names": "DOE",
    "phone": "2348****77844",
    "postal_code": "234",
    "state_code": "LAGOS"
  }
}
```

### Response Fields

| Field                     | Type   | Description                                       |
| ------------------------- | ------ | ------------------------------------------------- |
| entity                    | object | Contains the account verification response data   |
| entity.account\_currency  | string | Currency code of the bank account                 |
| entity.account\_name      | string | Full name on the bank account                     |
| entity.account\_number    | string | Masked bank account number                        |
| entity.account\_type      | string | Type code of the bank account                     |
| entity.address\_1         | string | Primary address of the account holder             |
| entity.address\_2         | string | Secondary address of the account holder           |
| entity.city               | string | City of the account holder                        |
| entity.country\_code      | string | Country code of the account holder                |
| entity.country\_of\_birth | string | Country of birth of the account holder            |
| entity.country\_of\_issue | string | Country of issue for the identity document        |
| entity.dob                | string | Date of birth of the account holder (DD/MM/YYYY)  |
| entity.expiry\_date       | string | Expiry date of the identity document (DD/MM/YYYY) |
| entity.first\_name        | string | First name of the account holder                  |
| entity.identity\_number   | string | Masked identity number linked to the account      |
| entity.identity\_type     | string | Type of identity document linked (e.g., BVN)      |
| entity.last\_name         | string | Last name of the account holder                   |
| entity.nationality        | string | Nationality of the account holder                 |
| entity.other\_names       | string | Other names (middle name) of the account holder   |
| entity.phone              | string | Masked phone number of the account holder         |
| entity.postal\_code       | string | Postal code of the account holder                 |
| entity.state\_code        | string | State of residence of the account holder          |

### Test Credentials for Sandbox

Kindly use this Test NUBAN in sandbox Environment

Account Number = `3046507407`
Bank Code = `011`