Bank directory API

Search, list and inspect financial institutions.

This documentation covers API V1.

Endpoints

http

GET https://api.fincode.example.com/v1/banks
GET https://api.fincode.example.com/v1/banks/{id}
GET https://api.fincode.example.com/v1/banks/search?q=
GET https://api.fincode.example.com/v1/banks/{id}/branches

List and search

List supports cursor pagination (limit, cursor). Search matches the English name, local name and short name, and returns the same envelope as list.

Name	Type	In	Description
q	string	query	Search term for /banks/search.
limit	integer	query	Page size, 1–100. Defaults to 20.
cursor	string	query	Pagination cursor from the previous response.
country	string	query	Filter by ISO 3166-1 alpha-2 country code.

Example request

bash

curl -s "https://api.fincode.example.com/v1/banks/search?q=chase&limit=5" \
  -H "Authorization: Bearer sk_test_xxx"

Example response

json

{
  "data": [
    {
      "id": "inst_jpmorgan",
      "name_en": "JPMorgan Chase Bank, N.A.",
      "short_name": "JPMorgan Chase",
      "country": "US",
      "identifiers": [
        { "type": "SWIFT", "value": "CHASUS33" },
        { "type": "ABA_ROUTING", "value": "021000021" }
      ]
    }
  ],
  "meta": { "request_id": "req_2c4e6g8i", "next_cursor": null }
}