> ## 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 KYC Status

> Check the KYC status of the owner of a Nigerian bank account (NUBAN). Returns tier and compliance status for the account holder.

### Request

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

### 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": "NGN",
    "account_name": "JOHN DOE MUSA",
    "account_number": "3046***407",
    "bank": "GTB",
    "kyc_status": "2",
    "first_name": "John",
    "identity_number": "*********556",
    "identity_type": "BVN",
    "last_name": "Musa",
    "other_names": "DOE",
  }
}
```

### Response Fields

| Field                    | Type   | Description                                        |
| ------------------------ | ------ | -------------------------------------------------- |
| entity                   | object | Contains the KYC status verification response data |
| entity.account\_currency | string | Currency of the bank account (e.g., NGN)           |
| entity.account\_name     | string | Full name on the bank account                      |
| entity.account\_number   | string | Masked bank account number                         |
| entity.bank              | string | Short name or code of the bank                     |
| entity.kyc\_status       | string | KYC tier/compliance status of the account holder   |
| 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.other\_names      | string | Other names (middle name) of the account holder    |

### Test Credentials for Sandbox

Kindly use this Test NUBAN in sandbox Environment

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