# Bank Codes

## Get List of Banks

This endpoint is used to fetch bank codes for a specific country. The request should include the country parameter in the query string.

**Request Parameters**

* country (string, required) : The name of the country for which the banks are to be retrieved

**Request & Responses example**

The response will include a list of banks based on the specific country

{% tabs %}
{% tab title="Example Request" %}

```url
curl --location 'https://api.tumapay.com/api/get-banks?country=NIGERIA'
```

{% endtab %}

{% tab title="Example Success Response" %}

```json
{
    "success": true,
    "message": "API Request was successful",
    "status_code": 100,
    "country": "kenya",
    "banks": [
    
        {
            "BankName": "ABC Bank",
            "BankCode": "35"
        },
        {
            "BankName": "Absa Bank Kenya Plc",
            "BankCode": "03"
        },
        {
            "BankName": "Bank of Africa",
            "BankCode": "19"
        },

        ]
}
```

{% endtab %}

{% tab title="Example Failed Response" %}

```json
{
 "success": false,
 "message": "No banks found ",
 "status_code": 404,
 "country": country

}
```

{% endtab %}
{% endtabs %}