# Verify Account Details

## Verify Account Details

<mark style="color:green;">`POST`</mark> `https://api.cngn.co/v1/api/account/verify`

Resolves and returns the account name and details for a given bank code and account number.

#### Request Body

| Name                                            | Type   | Description                                                                |
| ----------------------------------------------- | ------ | -------------------------------------------------------------------------- |
| bankCode<mark style="color:red;">\*</mark>      | string | CBN bank code. Use the **Get Bank List** endpoint to retrieve valid codes. |
| accountNumber<mark style="color:red;">\*</mark> | string | Bank account number to verify.                                             |

{% tabs %}
{% tab title="200 Account details verified successfully" %}

```json
{
  "status": 200,
  "message": "Account details verified successfully",
  "data": {
    "accountName": "JOHN DOE ENTERPRISES",
    "accountNumber": "0123456789",
    "bankCode": "044"
  }
}
```

{% endtab %}

{% tab title="400 Invalid request" %}

```json
{
  "status": 400,
  "message": "Could not resolve account"
}
```

{% endtab %}
{% endtabs %}

#### Response Fields (Decrypted)

| Field           | Type   | Description                         |
| --------------- | ------ | ----------------------------------- |
| `accountName`   | string | Resolved account holder name        |
| `accountNumber` | string | The verified account number         |
| `bankCode`      | string | The bank code used for verification |

#### Example Request

```bash
curl -X POST https://api.cngn.co/v1/api/account/verify \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "bankCode": "044",
    "accountNumber": "0123456789"
  }'
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cngn.co/integrations/endpoints/verify-account-details.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.