---
title: Retrieve Country Bank List API
slug: retrieve-country-bank-list
url: https://apyhub.com/apyhub/service/retrieve-country-bank-list
provider: ApyHub
categories: [Finance, Standard Data]
tags: [bank-directory, bank-lookup, country-data, swift-codes, financial-reference]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 2
atoms: 20
mcp: true
---

# Retrieve Country Bank List API

Bank list API: get every bank in a country with its name, local bank code and SWIFT/BIC, for payout forms and bank dropdowns. Free tier, no card.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/apyhub/retrieve-country-bank-list/bank/countries` | What it does Returns the list of countries supported by the bank service. The response is a JSON ob… | 20 |
| GET | `https://api.eu.apyhub.com/apyhub/retrieve-country-bank-list/bank/countries/:country/banks` | What it does Returns the list of banks for the specified country as a JSON object containing a data… | 20 |

## Endpoint reference

### List supported countries

`GET https://api.eu.apyhub.com/apyhub/retrieve-country-bank-list/bank/countries` · 20 atoms · accepts `application/json` · returns `application/json`

#### Quickstart

Fetch the list of supported bank countries.

```bash
curl -X GET "https://api.eu.apyhub.com/apyhub/retrieve-country-bank-list/bank/countries" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` array field. Each item in `data` is an object with `name`, `code`, and `currency` fields.

```json
{
  "data": [
    {
      "name": "Nigeria",
      "code": "NG",
      "currency": "NGN"
    }
  ]
}
```

### List banks for a country

`GET https://api.eu.apyhub.com/apyhub/retrieve-country-bank-list/bank/countries/:country/banks` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `country` | path | string | yes | Example: `NG`. |

#### Quickstart

Fetch the list of banks for a country code, such as `NG`.

```bash
curl -X GET "https://api.eu.apyhub.com/apyhub/retrieve-country-bank-list/bank/countries/:country/banks" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` array. Each item in the array is an object with `id` (integer), `name` (string), `code` (string or `null`), and `SWIFT` (string or `null`).

```json
{
  "data": [
    {
      "id": 1,
      "name": "Access Bank",
      "code": "044",
      "SWIFT": "ABNGNGLA"
    }
  ]
}
```

## About

## What it does
The Bank List API returns the banks in a country with their names, local bank codes, and SWIFT/BIC codes. Call `/bank/countries` to get the supported countries, each with its ISO 3166-1 alpha-2 `code` and ISO 4217 `currency`, then call `/bank/countries/{country}/banks` with a code such as `NG`, `KE`, or `GR` to get that country's list as a `data` array of `id`, `name`, `code`, and `SWIFT`.

Coverage spans over 200 countries and territories, and the country code works in upper or lower case. Local bank codes are filled where a country uses them: Nigeria returns the CBN and NIBSS codes payment providers expect, such as `044` for Access Bank and `057` for Zenith Bank. Elsewhere `code` can be `null` and the SWIFT/BIC is the identifier to use, so handle both fields as nullable. Lists include banks, microfinance banks, and other institutions registered for SWIFT. An unsupported code returns `Unsupported country`.

Use the bank list API to build bank dropdowns in payout and beneficiary forms, look up bank codes in Nigeria for transfers, prefill SWIFT codes in onboarding, or map bank names during payment reconciliation.

Check account details with the [IBAN Validation API](https://apyhub.com/apyhub/service/validate-iban) and confirm codes with the [SWIFT Code Validator API](https://apyhub.com/apyhub/service/validate-swift-bic-code). For US routing numbers, use the [US Bank Routing Number API](https://apyhub.com/werouteapi/service/us-bank-directory-lookup-api), and for full country details, the [Countries Dictionary API](https://apyhub.com/apyhub/service/list-all-countries).

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/retrieve-country-bank-list