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

# Bank List API

List supported countries and banks by country code, with currency and SWIFT/BIC data where available. Useful for payment forms and onboarding flows.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyverse.com/testcreate/bank-list-api` | What it does Returns the list of supported countries for the bank list API. The response is a JSON… | 20 |
| GET | `https://api.eu.apyverse.com/testcreate/bank-list-api/countries/:country` | What it does Returns the list of banks for the specified country. The country code is provided as a… | 20 |

## Endpoint reference

### List supported countries

`GET https://api.eu.apyverse.com/testcreate/bank-list-api` · 20 atoms · accepts `application/json` · returns `application/json`

#### Quickstart

Fetch the list of bank countries with a simple GET request.

```bash
curl -X GET "https://api.eu.apyverse.com/testcreate/bank-list-api" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` array. Each item in `data` is an object with `name`, `code`, and `currency` fields describing a country and its ISO codes.

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

### List banks for a country

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

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `country` | path | string | yes | One of: ZW, NG, LS, MW, MZ, ZM, CD, EG, TZ, GH, CN, IN, PK, BD, PH, MY, NP, SG, LK, TH. Example: `NG`. |

#### Quickstart

Fetch the list of banks for a country by putting the country code in the path.

```bash
curl -X GET "https://api.eu.apyverse.com/testcreate/bank-list-api/countries/:country/NG" \
  -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
Bank Directory gives you a simple way to look up supported countries and the banks available in each one. Send a country code, get back the country list or a bank list with the fields exposed by the schema: `name`, `code`, `currency` for countries, and `id`, `name`, `code`, `SWIFT` for banks.

Use it when you need reference data for bank selection forms, payout setup, or payment onboarding flows. The country endpoint returns ISO 3166-1 alpha-2 codes alongside the country name and ISO 4217 currency code, which makes it easier to build country-aware finance workflows. The bank endpoint is scoped to a supported country code such as `NG`, `GH`, `IN`, or `SG` and returns the banks known for that market.

Bank Directory is best for systems that need a maintained bank list without scraping or hardcoding it into your application. It keeps the response shape small and predictable, so you can populate dropdowns, validate user selections, or map local bank details to SWIFT/BIC data where available.

## Usage

Base URL: `https://api.eu.apyverse.com` (default region — see
`GET https://apyverse.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://apyverse.com/testcreate/service/bank-list-api