apyhub
Back
▣ FINANCE · STANDARD DATA

Retrieve Country Bank List API

Hosted on ApyHub

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 and confirm codes with the SWIFT Code Validator API. For US routing numbers, use the US Bank Routing Number API, and for full country details, the Countries Dictionary API.

▣ ENDPOINT 01 / 02
GET
List supported countries
https://api.eu.apyhub.com/apyhub/retrieve-country-bank-list/bank/countries

QUICKSTART

GUIDE

Quickstart

Fetch the list of supported bank countries.

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.

{
  "data": [
    {
      "name": "Nigeria",
      "code": "NG",
      "currency": "NGN"
    }
  ]
}
TRY ITLIVE · 20 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns the list of countries supported by the bank service. The response is a JSON object containing a data array of country objects.

Response

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

ParameterTypeDescription
dataObject ArrayArray of supported country objects. Each item includes:
- name (String, required)
- code (String, required, ISO 3166-1 alpha-2 country code)
- currency (String, required, ISO 4217 currency code)
▣ ENDPOINT 02 / 02
GET
List banks for a country
https://api.eu.apyhub.com/apyhub/retrieve-country-bank-list/bank/countries/:country/banks

QUICKSTART

GUIDE

Quickstart

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

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).

{
  "data": [
    {
      "id": 1,
      "name": "Access Bank",
      "code": "044",
      "SWIFT": "ABNGNGLA"
    }
  ]
}
TRY ITLIVE · 20 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns the list of banks for the specified country as a JSON object containing a data array. Each array item is a bank record with id, name, code, and SWIFT fields.

Path Parameter(s)

AttributeTypeDescription
countryString2 letter Country code. Fetch the supported list from List supported countries endpoint

Response

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

ParameterTypeDescription
dataObject ArrayArray of bank objects. Each item includes id, name, code, and SWIFT.
data[].idIntegerPosition of the bank in the sorted list, starting at 1.
data[].nameStringBank name.
data[].codeStringLocal bank code, or null when the country has none or it is unknown.
data[].SWIFTStringSWIFT/BIC code, or null when unknown.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLCountries Dictionary APIApyHubCALLCurrencies Dictionary APIApyHubCALLRetrieve World Bank Public Data APIDosvak LLCCALLUS Bank Directory & Lookup APIAnis Ben Fadhel

From the blog

Reads that touch this API.

Ultimate Guide to Country Codes: What They Are and How to Use ThemJul 9, 2026Validate IBAN API: IBAN Validation for Developers and Secure PaymentsJul 9, 2026Getting Started with APIs: A Beginner’s Guide 2026Sep 17, 2026IFSC Code Validation API: Verify Indian Bank Details Before You Send MoneyAug 7, 2026