# 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"
  }'
```
