Can I use the Banks API for commercial purposes?

Yes, but you must have a premium subscription. Commercial use of the Banks API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.

How do I get an API key and start using the Banks API?

Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.

What happens if I exceed my quota for the month?

Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page .

What happens if a request to the Banks API fails?

The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.

How do I look up a bank by SWIFT code, routing number or IBAN?

On paid plans , pass the code to /v1/banks : swift=CHASUS33 , routing_number=021000021 , iban=DE89370400440532013000 , lei=7H6GLXDRUGQFU57RNE97 , domain=chase.com , or a national bank code with its country, e.g. country=DE&bank_code=37040044 . Each returns the bank's full record with all of its other identifiers, so you can also turn one code into another.

Which countries does the Banks API cover?

Over 200 countries and territories, including small countries that most bank datasets leave out, such as Bhutan, Fiji, Iceland, the Maldives and Seychelles. /v1/bankslist?country=BT lists the active banks in a country.

How do I build a bank picker for a country?

Call /v1/bankslist?country=NG . It returns the active banks in the country, the most prominent first, with each bank's id, name, short name, type and a logo thumbnail. The free plan gets up to 250 banks per country. Paid plans page through the full list with limit and offset and add each bank's SWIFT code and national bank codes.

How is the Banks API different from the SWIFT Code API?

The SWIFT Code API returns the SWIFT codes of individual bank branches. The Banks API returns one record per bank, including banks without a SWIFT code, with all of its identifiers (head office SWIFT code, LEI, routing numbers and national bank codes) and details such as its licence, logo, deposit insurance, payment networks and ownership.

How do I keep my bank data up to date?

Store each bank by its id , which never changes. On the Business tier and above , call /v1/bankchanges?since=2026-10-01 with the date of your last sync to get new banks, renames, mergers, failures, SWIFT code changes and sanctions listings. Every record also has updated_at .

What do the free and paid plans include?

The free plan gets each bank's name, type, status, country, head office city, website and logo thumbnail, search by name and country, and up to 250 banks per country from /v1/bankslist . Paid plans (Developer and above) add every identifier, lookups by SWIFT code, LEI, routing number, bank code, IBAN and domain, the full address, logo, brand colors, licence, deposit insurance and systemic importance. Business, Professional and Enterprise plans add ownership, payment networks, sanctions, financials, history and /v1/bankchanges .

Banks API

The Banks API returns banks and other licensed deposit-taking institutions in over 200 countries and territories, from the largest global banks to small local lenders. Search by name in any language, look a bank up by SWIFT/BIC code, LEI, routing number, national bank code, IBAN or website domain, or list the banks in a country.

Each record includes the bank's identifiers, type, status, head office, website and logo, along with its licence, deposit insurance, payment networks, ownership, sanctions status, financials and history.

Available endpoints:

/v1/banks - Search and look up banks
/v1/bankslist - Banks in a country
/v1/bankchanges - Changes since a date

Online

(4.1)

From 5,869 users

2,700+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average	P50	P75	P90	P95
427ms	476ms	508ms	635ms	1300ms

Didn't find what you were looking for? Suggest an improvement

3 endpoints

https://api.api-ninjas.com/v1/banks

Finds banks by name or country, or looks one up by SWIFT/BIC code, LEI, routing number, national bank code, IBAN or website domain. Name searches put the best-known match first.

Parameters

At least one parameter other than limit, offset and status is required. Combine them to narrow a search, e.g. name=first national&country=US&type=commercial_bank.

name optional
Name of the bank, or part of it, e.g. chase or deutsche bank. Matches the official name, short name, local-language name and other known names; case, accents and legal suffixes such as Inc., AG and S.A. are ignored. Names in any script work, e.g. 中国银行.
country optional
Two-letter ISO 3166 country code of the bank's home country, e.g. US or NG.
id optional Premium only
A bank id from an earlier response. Returns that bank, whatever its status.
swift optional Premium only
SWIFT/BIC code, 8 or 11 characters, e.g. CHASUS33 or CHASUS33XXX. A branch code returns the bank it belongs to.
lei optional Premium only
Legal Entity Identifier, 20 characters.
routing_number optional Premium only
US ABA routing number, 9 digits, e.g. 021000021. Returns the bank that owns it.
bank_code optional Premium only
A national bank code (see bank code types). Requires country, e.g. country=DE&bank_code=37040044.
iban optional Premium only
An IBAN, with or without spaces, e.g. DE89 3704 0044 0532 0130 00. Returns the bank that holds the account.
domain optional Premium only
Website or email domain, e.g. chase.com. A URL or an email address also works.
type optional Premium only
One or more institution types, separated by commas, e.g. credit_union or commercial_bank,savings_bank.
status optional Premium only
active (default), inactive (merged, failed, closed and other former banks) or all.
payment_network optional Business tier and above
Only banks on this payment network, e.g. fednow, sepa_instant or pix. See payment networks.
min_assets optional Business tier and above
Only banks with total assets of at least this many US dollars, e.g. 1000000000.
max_assets optional Business tier and above
Only banks with total assets of at most this many US dollars.
sanctioned optional Business tier and above
true for sanctioned banks only, false to leave them out.
limit optional Premium only
Number of results to return (1-100). Default 10. The free plan returns up to 5.
offset optional Premium only
Number of results to skip, for paging. Default 0.

Headers

X-Api-Key required
API Key associated with your account.

Response

The /v1/banks endpoint returns a JSON array of banks with the following fields (an empty array when nothing matches), or an error if the request is unsuccessful (see errors).

Every field is always present: null or an empty array when it has no value. Fields marked Premium only return This field is for premium subscribers only. on the free plan, and fields marked Business tier and above return This field is for Business tier and above. on lower plans.

id
Unique API Ninjas id of the bank. It never changes; pass it as id to fetch the bank again.
name
Official name of the bank.
short_name
Common short or brand name, e.g. Chase.
native_name
Name in the local language or script, e.g. 中国银行, when it differs from name.
aliases Premium only
Other names the bank is known by: trade names, abbreviations and other spellings.
institution_type
The kind of institution, e.g. commercial_bank or credit_union. See institution types.
status
active for a bank operating today; otherwise merged, failed, closed, license_revoked, in_liquidation or inactive. See statuses.
status_date Premium only
Date of the latest status change, e.g. the date of a merger or failure (YYYY-MM-DD).
successor Premium only
For a merged or failed bank: the bank that took it over, with id and name.
founded_year
Year the bank was founded.
country, country_code
Country name and two-letter ISO 3166 code of the bank's home country, e.g. United States and US.
headquarters
Head office location, with the fields below.
headquarters.city
City of the head office.
headquarters.address, headquarters.postal_code Premium only
Street address and postal code.
headquarters.region, headquarters.region_code Premium only
State, province or region, and its code, e.g. Ohio and OH.
headquarters.latitude, headquarters.longitude Premium only
Coordinates of the head office.
phone Premium only
Main phone number.
website
Official website.
domains Premium only
Website and email domains of the bank, e.g. chase.com. Search them with domain.
logo Premium only
URL of the bank's logo at the largest size available (PNG).
logo_thumbnail
URL of a small logo (PNG, up to 64 × 64 pixels), for lists and bank pickers.
brand_colors Premium only
The bank's brand colors as hex codes, primary and secondary, e.g. #117ACA.
swift_code Premium only
Head office SWIFT/BIC code, 11 characters, e.g. CHASUS33XXX. Branch SWIFT codes are in the SWIFT Code API.
swift_connected Premium only
true when the SWIFT code is connected to the SWIFT network; false for a code used only to identify the bank.
lei Premium only
Legal Entity Identifier, 20 characters.
bank_codes Premium only
National bank codes, e.g. US routing numbers or the German Bankleitzahl, each with type, code and primary (true for the bank's main code of that type). See bank code types.
regulator_ids Premium only
Registration numbers with regulators and company registers, each with type and id, e.g. an FDIC certificate or an FCA Firm Reference Number. See regulator ID types.
regulatory Premium only
The bank's licence, with the fields below.
regulatory.license_type
Licence category as the regulator names it, e.g. national_bank, credit_institution or federal_credit_union.
regulatory.regulator
The supervising authority, e.g. Office of the Comptroller of the Currency.
regulatory.license_status
active, inactive or a more specific status such as supervised_run_off.
regulatory.deposit_taking
true when the bank may take deposits from the public.
deposit_insurance Premium only
Deposit protection, with the fields below.
deposit_insurance.insured
true when the bank's deposits are covered by a deposit insurance scheme.
deposit_insurance.scheme
The scheme, e.g. Federal Deposit Insurance Corporation.
deposit_insurance.coverage_limit, deposit_insurance.currency
Standard coverage per depositor and its currency, e.g. 250000 and USD.
systemic Premium only
gsib: true for a global systemically important bank (G-SIB). dsib: true for a domestic systemically important bank (D-SIB) in its country.
ownership Business tier and above
Who owns the bank, with the fields below.
ownership.ownership_type
subsidiary, cooperative, mutual or state_owned.
ownership.parent, ownership.ultimate_parent
The direct and the top-level parent company, each with name, lei, country_code and id (the parent's Banks API id when the parent is itself a bank).
ownership.ticker, ownership.exchange
When the bank itself is listed: its stock ticker and the exchange it trades on, e.g. BCGE and SIX Swiss Exchange.
payment_networks Business tier and above
Payment networks the bank takes part in, e.g. fedwire, fednow, sepa_instant or pix. See payment networks.
compliance Business tier and above
sanctioned: true when the bank is on the US (OFAC), EU, UK or UN sanctions lists. sanctions_programs: the programs that list it, prefixed with the list, e.g. OFAC:RUSSIA-EO14024, EU:UKR or UN:DPRK.
financials Business tier and above
Latest reported figures: as_of (YYYY-MM-DD), currency, total_assets, total_deposits, total_equity, net_income_ytd (net income from the start of the year to as_of) and branch_count.
history Business tier and above
The bank's history, with the fields below.
history.former_names
Earlier names, each with name and until (the last date it was used, YYYY-MM-DD).
history.predecessors
Banks that merged into this one, each with name, date and event (merger or succession).
history.failure
For a failed bank: date, resolution (failure, or assistance when it was rescued with assistance) and acquirer, the bank that took over its deposits.
updated_at
Date any field of the record last changed (YYYY-MM-DD).

Institution Types

The institution_type of each bank, also accepted by the type parameter.

institution_type	Meaning
`commercial_bank`	A bank serving retail and business customers.
`savings_bank`	A savings bank or savings institution, e.g. a German Sparkasse or a US savings association.
`cooperative_bank`	A bank owned by its members, e.g. a Volksbank, Raiffeisen bank or urban cooperative bank.
`credit_union`	A credit union.
`building_society`	A building society.
`microfinance_bank`	A microfinance bank or deposit-taking microfinance institution.
`development_bank`	A development or policy bank.
`investment_bank`	An investment, merchant or private bank.
`trust_company`	A trust company or trust bank.
`postal_bank`	A postal bank or postal savings bank.
`payment_bank`	A payments bank or payment service bank.
`central_bank`	A central bank or monetary authority.
`e_money_institution`	An electronic money institution.
`payment_institution`	A licensed payment institution.
`mobile_money_operator`	A mobile money operator.
`finance_company`	A licensed finance or credit company.
`foreign_bank_branch`	A branch of a bank from another country.
`other`	Another kind of licensed institution.

Statuses

The status of each bank.

status	Meaning
`active`	Operating today.
`merged`	Merged into another bank, named in `successor`.
`failed`	Failed. `history.failure` has the date and how it was resolved.
`closed`	Closed or voluntarily wound up.
`license_revoked`	Its licence was revoked.
`in_liquidation`	Being liquidated.
`inactive`	No longer listed as an active institution, without a stated reason, e.g. removed from its register.

Bank Code Types

The type of each entry in bank_codes. Search any of them with bank_code and country, and US routing numbers with routing_number.

type	Meaning
`aba_routing_number`	United States: ABA routing number, 9 digits. A bank can have several. E.g. `021000021`.
`au_bsb_prefix`	Australia: The first 3 digits of the bank's BSB numbers. E.g. `062`.
`br_compe`	Brazil: COMPE bank number, 3 digits. E.g. `341`.
`br_ispb`	Brazil: ISPB code, 8 digits, used for Pix and STR payments. E.g. `60701190`.
`ca_institution_number`	Canada: Institution number, 3 digits. E.g. `001`.
`ch_iid`	Switzerland, Liechtenstein: IID (bank clearing number), 5 digits. E.g. `00230`.
`de_blz`	Germany: Bankleitzahl (BLZ), 8 digits. E.g. `37040044`.
`es_bank_code`	Spain: Bank code (código de entidad), 4 digits. E.g. `0049`.
`fr_cib`	France, Monaco and French overseas territories: Bank code (code banque), 5 digits. E.g. `30003`.
`hk_bank_code`	Hong Kong: Bank code, 3 digits. E.g. `004`.
`il_bank_code`	Israel: Bank code, 2 to 3 digits. E.g. `010`.
`in_ifsc_prefix`	India: The first 4 characters of the bank's IFSC codes. E.g. `HDFC`.
`it_abi`	Italy: ABI code, 5 digits. E.g. `03069`.
`mx_bank_code`	Mexico: Bank code, 3 digits. E.g. `012`.
`mx_spei_code`	Mexico: SPEI participant code, 5 digits. E.g. `40012`.
`ng_cbn_code`	Nigeria: Central Bank of Nigeria bank code, 3 digits. E.g. `058`.
`ng_nip_code`	Nigeria: NIP institution code, 6 digits, used for instant transfers. E.g. `090405`.
`nl_bank_identifier`	Netherlands: Bank identifier in Dutch IBANs, 4 letters. E.g. `ABNA`.

Regulator ID Types

The type of each entry in regulator_ids.

type	Meaning
`fdic_certificate`	United States: FDIC certificate number.
`rssd_id`	United States: Federal Reserve RSSD ID.
`ncua_charter`	United States: NCUA credit union charter number.
`occ_charter`	United States: OCC charter number.
`fca_frn`	United Kingdom and Gibraltar: FCA Firm Reference Number (FRN).
`ecb_riad_code`	European Union: ECB RIAD code of a monetary financial institution.
`bafin_id`	Germany: BaFin institution ID.
`regafi_id`	France and the EU: REGAFI register ID.
`it_albo_number`	Italy: Bank of Italy register (albo) number.
`cssf_code`	Luxembourg: CSSF register code.
`cnpj`	Brazil: CNPJ company number (first 8 digits).
`cbn_institution_id`	Nigeria: Central Bank of Nigeria institution ID.
`hkma_institution_id`	Hong Kong: HKMA authorized institution ID.
`jp_corporate_number`	Japan: corporate number, 13 digits.
`no_org_number`	Norway: organisation number.
`is_kennitala`	Iceland: kennitala.
`national_id`	The company registration or tax number in the bank's home country, e.g. `HRB 30000` for a German commercial register entry.

Payment Networks

The values of payment_networks, also accepted by the payment_network parameter.

payment_networks	Meaning
`fedach`	United States: FedACH, the Federal Reserve's ACH service.
`fedwire`	United States: Fedwire Funds Service, for same-day wire transfers.
`fednow`	United States: FedNow instant payments.
`rtp`	United States: RTP instant payments.
`sepa_credit_transfer`	SEPA countries: SEPA Credit Transfer, euro bank transfers.
`sepa_instant`	SEPA countries: SEPA Instant Credit Transfer.
`target2`	Euro area: T2 (TARGET2), the euro area's high-value payment system.
`faster_payments`	United Kingdom: Faster Payments.
`bacs`	United Kingdom: Bacs Direct Credit and Direct Debit.
`chaps`	United Kingdom: CHAPS, for same-day high-value payments.
`sic`	Switzerland: SIC, Swiss franc interbank payments.
`euro_sic`	Switzerland: euroSIC, euro payments in Switzerland.
`pix`	Brazil: Pix instant payments.
`str`	Brazil: STR, Brazil's high-value payment system.
`spei`	Mexico: SPEI interbank transfers.
`npp`	Australia: New Payments Platform (NPP), including PayID and Osko.

Errors

An invalid request returns HTTP 400 with a readable error message. Authentication and quota errors use the standard format described in error codes.

No parameter other than limit, offset or status
At least one parameter ('name' or 'country') is required.
An unknown parameter
Unknown parameter 'foo'.
A value that is not valid, e.g. swift=CHASE
Parameter 'swift' must be an 8 or 11 character SWIFT/BIC code.
bank_code without country
Parameter 'bank_code' requires the 'country' parameter.
A Premium-only parameter on the free plan
Parameter 'swift' is for premium subscribers only.
A Business-tier parameter on a lower plan
Parameter 'payment_network' requires a Business plan or higher.

Live Demo

Live demo · no API key required

Query parameters

name

country

Get a free API key to get started — no credit card required.

Headers

X-Api-KeyLog in or sign up to get your API key

GET

https://api.api-ninjas.com/v1/banks?name=jpmorgan%20chase

Sample response

[

{

"id": 117048,

"name": "JPMorgan Chase Bank, National Association",

"short_name": "Chase",

"native_name": null,

"aliases": [

"Chase",

"Chase Private Client",

"J.P.Morgan",

"J.P.Morgan Private Bank",

"JPMorgan Chase",

"JPMorgan Chase Bank, N.A.",

"..."

"institution_type": "commercial_bank",

"status": "active",

"status_date": null,

"successor": null,

"founded_year": 1824,

"country": "United States",

"country_code": "US",

"headquarters": {

"address": "1111 Polaris Pkwy",

"city": "Columbus",

"region": "Ohio",

"region_code": "OH",

"postal_code": "43240",

"latitude": 40.142089249632,

"longitude": -82.996085855642

"phone": null,

"website": "https://www.jpmorganchase.com",

"domains": [

"chase.com",

"jpmorgan.chase.com",

"jpmorgan.com",

"jpmorganchase.com"

"logo": "https://media.api-ninjas.com/banks/logo/117048_f5063b37229ba96a.png",

"logo_thumbnail": "https://media.api-ninjas.com/banks/thumb/117048.png",

"brand_colors": {

"primary": "#000000",

"secondary": null

"swift_code": "CHASUS33XXX",

"swift_connected": true,

"lei": "7H6GLXDRUGQFU57RNE97",

"bank_codes": [

{

"code": "011701398",

"primary": false,

"type": "aba_routing_number"

{

"code": "021000021",

"primary": false,

"type": "aba_routing_number"

{

"code": "021000128",

"primary": false,

"type": "aba_routing_number"

"..."

"regulator_ids": [

{

"id": "628",

"type": "fdic_certificate"

{

"id": "852218",

"type": "rssd_id"

}

"regulatory": {

"license_type": "national_bank",

"regulator": "Office of the Comptroller of the Currency",

"license_status": "active",

"deposit_taking": true

"deposit_insurance": {

"insured": true,

"scheme": "Federal Deposit Insurance Corporation",

"coverage_limit": 250000,

"currency": "USD"

"systemic": {

"gsib": true,

"dsib": true

"ownership": {

"ownership_type": "subsidiary",

"parent": {

"id": null,

"name": "JPMORGAN CHASE & CO.",

"lei": "8I5DZWZKVSZI1NUHU748",

"country_code": "US"

"ultimate_parent": {

"id": null,

"name": "JPMORGAN CHASE & CO.",

"lei": "8I5DZWZKVSZI1NUHU748",

"country_code": "US"

"ticker": null,

"exchange": null

"payment_networks": [

"fedach",

"fednow",

"fedwire",

"rtp"

"compliance": {

"sanctioned": false,

"sanctions_programs": []

"financials": {

"as_of": "2026-06-30",

"currency": "USD",

"total_assets": 4091315000000,

"total_deposits": 2820284000000,

"total_equity": 341580000000,

"net_income_ytd": 31335000000,

"branch_count": 5413

"history": {

"former_names": [

{

"name": "Chemical Bank New York Trust Company",

"until": null

{

"name": "Chemical Bank",

"until": null

{

"name": "The Chase Manhattan Bank",

"until": null

{

"name": "Chemical Bank & Trust Company",

"until": null

{

"name": "Chemical Corn Exchange Bank",

"until": null

}

"predecessors": [],

"failure": null

"updated_at": "2026-11-04"

"..."

]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/banks?name=jpmorgan%20chase" \
  -H "X-Api-Key: YOUR_API_KEY"

https://api.api-ninjas.com/v1/bankslist

Lists the active banks in one country, the most prominent first, with compact rows for bank pickers, dropdowns and onboarding forms. The free plan gets up to 250 banks per country; paid plans page through the full list.

Parameters

country required
Two-letter ISO 3166 country code, e.g. IS or NG.
type optional Premium only
One or more institution types, separated by commas, e.g. commercial_bank.
status optional Premium only
active (default), inactive or all.
payment_network optional Business tier and above
Only banks on this payment network, e.g. sepa_instant. See payment networks.
limit optional
Number of banks to return (1-1000). Default 500. On the free plan, 1-250, default 250.
offset optional Premium only
Number of banks to skip, for paging through the full list. Default 0.

Headers

X-Api-Key required
API Key associated with your account.

Response

The /v1/bankslist endpoint returns a JSON array of banks with the following fields, or an error if the request is unsuccessful (see errors).

id
The bank's id. Pass it to /v1/banks as id for the full record.
name, short_name
Official name and common short name.
institution_type
See institution types.
logo_thumbnail
URL of a small logo (PNG, up to 64 × 64 pixels).
swift_code Premium only
Head office SWIFT/BIC code.
bank_codes Premium only
National bank codes, as in /v1/banks.
updated_at
Date the bank's record last changed (YYYY-MM-DD).
payment_networks Business tier and above
Payment networks the bank takes part in.

Errors

An invalid request returns HTTP 400 with a readable error message. Authentication and quota errors use the standard format described in error codes.

No country
Parameter 'country' is required (2-letter ISO 3166 code, e.g. NG).
A limit above 250 on the free plan
Parameter 'limit' must be between 1 and 250.
offset on the free plan
Parameter 'offset' is for premium subscribers only.

Live Demo

Live demo · no API key required

Query parameters

country

Get a free API key to get started — no credit card required.

Headers

X-Api-KeyLog in or sign up to get your API key

GET

https://api.api-ninjas.com/v1/bankslist?country=IS

Sample response

[

{

"id": 103330,

"name": "Arion banki hf.",

"short_name": null,

"institution_type": "commercial_bank",

"logo_thumbnail": "https://media.api-ninjas.com/banks/thumb/103330.png",

"swift_code": "ESJAISREXXX",

"bank_codes": [],

"updated_at": "2026-11-04",

"payment_networks": [

"sepa_credit_transfer"

]

{

"id": 103323,

"name": "Íslandsbanki hf.",

"short_name": null,

"institution_type": "commercial_bank",

"logo_thumbnail": "https://media.api-ninjas.com/banks/thumb/103323.png",

"swift_code": "GLITISREXXX",

"bank_codes": [],

"updated_at": "2026-11-04",

"payment_networks": [

"sepa_credit_transfer"

]

{

"id": 103326,

"name": "Landsbankinn hf.",

"short_name": null,

"institution_type": "commercial_bank",

"logo_thumbnail": "https://media.api-ninjas.com/banks/thumb/103326.png",

"swift_code": "NBIIISREXXX",

"bank_codes": [],

"updated_at": "2026-11-04",

"payment_networks": [

"sepa_credit_transfer"

]

{

"id": 115432,

"name": "Seðlabanki Íslands",

"short_name": null,

"institution_type": "commercial_bank",

"logo_thumbnail": "https://media.api-ninjas.com/banks/thumb/115432.png",

"swift_code": "SISLISREXXX",

"bank_codes": [],

"updated_at": "2026-11-06",

"payment_networks": []

"..."

]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/bankslist?country=IS" \
  -H "X-Api-Key: YOUR_API_KEY"

Business tier and above

https://api.api-ninjas.com/v1/bankchanges

Returns changes to bank records since a date, newest first: new banks, renames, mergers, failures, closures, revoked licences, SWIFT code changes and sanctions listings. Use it to keep a copy of the data in sync or to be alerted when a bank you work with changes. Business plans can request the last 365 days; Professional and Enterprise plans have no limit.

Parameters

since required
Earliest change date (YYYY-MM-DD), inclusive.
country optional
Two-letter ISO 3166 country code, e.g. US.
change_type optional
One or more change types, separated by commas, e.g. merged,failed.
limit optional
Number of changes to return (1-1000). Default 100.
offset optional
Number of changes to skip, for paging. Default 0.

Headers

X-Api-Key required
API Key associated with your account.

Response

The /v1/bankchanges endpoint returns a JSON array of changes with the following fields, or an error if the request is unsuccessful (see errors).

date
Date the change was recorded (YYYY-MM-DD). The bank's status_date has the date a merger or failure took effect.
change_type
See change types.
bank
The bank, with id, name and country_code.
previous, current
The value before and after the change: the old and new name, status or SWIFT code. null for types without a value, such as new.
successor
For a merger or failure: the bank that took over, with id and name.

Change Types

The change_type of each change, also accepted by the change_type parameter.

change_type	Meaning
`new`	A bank was added.
`renamed`	The bank's `name` changed.
`merged`	The bank merged into another bank.
`failed`	The bank failed.
`closed`	The bank closed.
`license_revoked`	The bank's licence was revoked.
`status_changed`	Another change of `status`, e.g. to `in_liquidation`.
`swift_code_added`	The bank received a SWIFT code.
`swift_code_removed`	The bank's SWIFT code was removed.
`swift_code_changed`	The bank's head office SWIFT code changed.
`sanctioned`	The bank was added to a sanctions list.
`unsanctioned`	The bank was removed from every sanctions list.

Errors

An invalid request returns HTTP 400 with a readable error message. Authentication and quota errors use the standard format described in error codes.

A plan below the Business tier
The bank changes endpoint requires a Business plan or higher.
No since
Parameter 'since' is required (YYYY-MM-DD).
A since date more than 365 days ago on a Business plan
Business plans can request changes from the last 365 days. Full history requires a Professional plan or higher.

Live Demo

Live demo

Query parameters

since

Get a free API key to get started — no credit card required.

Headers

X-Api-KeyLog in or sign up to get your API key

GET

https://api.api-ninjas.com/v1/bankchanges?since=2026-10-01

Sample response

[

{

"date": "2026-10-13",

"change_type": "merged",

"bank": {

"id": 134740,

"name": "Midland Community Bank",

"country_code": "US"

"previous": "active",

"current": "merged",

"successor": {

"id": 113723,

"name": "United Community Bank"

}

"..."

]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/bankchanges?since=2026-10-01" \
  -H "X-Api-Key: YOUR_API_KEY"

Frequently Asked Questions

Can I use the Banks API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Banks API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
How do I get an API key and start using the Banks API?
Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
What happens if a request to the Banks API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
How do I look up a bank by SWIFT code, routing number or IBAN?
On paid plans, pass the code to /v1/banks: swift=CHASUS33, routing_number=021000021, iban=DE89370400440532013000, lei=7H6GLXDRUGQFU57RNE97, domain=chase.com, or a national bank code with its country, e.g. country=DE&bank_code=37040044. Each returns the bank's full record with all of its other identifiers, so you can also turn one code into another.
Which countries does the Banks API cover?
Over 200 countries and territories, including small countries that most bank datasets leave out, such as Bhutan, Fiji, Iceland, the Maldives and Seychelles. /v1/bankslist?country=BT lists the active banks in a country.
How do I build a bank picker for a country?
Call /v1/bankslist?country=NG. It returns the active banks in the country, the most prominent first, with each bank's id, name, short name, type and a logo thumbnail. The free plan gets up to 250 banks per country. Paid plans page through the full list with limit and offset and add each bank's SWIFT code and national bank codes.
How is the Banks API different from the SWIFT Code API?
The SWIFT Code API returns the SWIFT codes of individual bank branches. The Banks API returns one record per bank, including banks without a SWIFT code, with all of its identifiers (head office SWIFT code, LEI, routing numbers and national bank codes) and details such as its licence, logo, deposit insurance, payment networks and ownership.
How do I keep my bank data up to date?
Store each bank by its id, which never changes. On the Business tier and above, call /v1/bankchanges?since=2026-10-01 with the date of your last sync to get new banks, renames, mergers, failures, SWIFT code changes and sanctions listings. Every record also has updated_at.
What do the free and paid plans include?
The free plan gets each bank's name, type, status, country, head office city, website and logo thumbnail, search by name and country, and up to 250 banks per country from /v1/bankslist. Paid plans (Developer and above) add every identifier, lookups by SWIFT code, LEI, routing number, bank code, IBAN and domain, the full address, logo, brand colors, licence, deposit insurance and systemic importance. Business, Professional and Enterprise plans add ownership, payment networks, sanctions, financials, history and /v1/bankchanges.

Explore API integration use cases for recommended APIs and workflow examples.

Banks API

/v1/banksGET

Parameters

name optional

country optional

id optional Premium only

swift optional Premium only

lei optional Premium only

routing_number optional Premium only

bank_code optional Premium only

iban optional Premium only

domain optional Premium only

type optional Premium only

status optional Premium only

payment_network optional Business tier and above

min_assets optional Business tier and above

max_assets optional Business tier and above

sanctioned optional Business tier and above

limit optional Premium only

offset optional Premium only

Headers

X-Api-Key required

Response

id

name

short_name

native_name

aliases Premium only

institution_type

status

status_date Premium only

successor Premium only

founded_year

country, country_code

headquarters

headquarters.city

headquarters.address, headquarters.postal_code Premium only

headquarters.region, headquarters.region_code Premium only

headquarters.latitude, headquarters.longitude Premium only

phone Premium only

website

domains Premium only

logo Premium only

logo_thumbnail

brand_colors Premium only

swift_code Premium only

swift_connected Premium only

lei Premium only

bank_codes Premium only

regulator_ids Premium only

regulatory Premium only

regulatory.license_type

regulatory.regulator

regulatory.license_status

regulatory.deposit_taking

deposit_insurance Premium only

deposit_insurance.insured

deposit_insurance.scheme

deposit_insurance.coverage_limit, deposit_insurance.currency

systemic Premium only

ownership Business tier and above

ownership.ownership_type

ownership.parent, ownership.ultimate_parent

ownership.ticker, ownership.exchange

payment_networks Business tier and above

compliance Business tier and above

financials Business tier and above

history Business tier and above

history.former_names

history.predecessors

history.failure

updated_at

Institution Types

Statuses

Bank Code Types

Regulator ID Types

Payment Networks

Errors

Live Demo

Code Examples

`name` optional

`country` optional

`id` optional Premium only

`swift` optional Premium only

`lei` optional Premium only

`routing_number` optional Premium only

`bank_code` optional Premium only

`iban` optional Premium only

`domain` optional Premium only

`type` optional Premium only

`status` optional Premium only

`payment_network` optional Business tier and above

`min_assets` optional Business tier and above

`max_assets` optional Business tier and above

`sanctioned` optional Business tier and above

`limit` optional Premium only

`offset` optional Premium only

`X-Api-Key` required

`id`

`name`

`short_name`

`native_name`

`aliases` Premium only

`institution_type`

`status`

`status_date` Premium only

`successor` Premium only

`founded_year`

`country, country_code`

`headquarters`

`headquarters.city`

`headquarters.address, headquarters.postal_code` Premium only

`headquarters.region, headquarters.region_code` Premium only

`headquarters.latitude, headquarters.longitude` Premium only

`phone` Premium only

`website`

`domains` Premium only

`logo` Premium only

`logo_thumbnail`

`brand_colors` Premium only

`swift_code` Premium only

`swift_connected` Premium only

`lei` Premium only

`bank_codes` Premium only

`regulator_ids` Premium only

`regulatory` Premium only

`regulatory.license_type`

`regulatory.regulator`

`regulatory.license_status`

`regulatory.deposit_taking`

`deposit_insurance` Premium only

`deposit_insurance.insured`

`deposit_insurance.scheme`

`deposit_insurance.coverage_limit, deposit_insurance.currency`

`systemic` Premium only

`ownership` Business tier and above

`ownership.ownership_type`

`ownership.parent, ownership.ultimate_parent`

`ownership.ticker, ownership.exchange`

`payment_networks` Business tier and above

`compliance` Business tier and above

`financials` Business tier and above

`history` Business tier and above

`history.former_names`

`history.predecessors`

`history.failure`

`updated_at`

`country` required

`type` optional Premium only

`status` optional Premium only

`payment_network` optional Business tier and above

`limit` optional

`offset` optional Premium only

`X-Api-Key` required

`id`

`name, short_name`

`institution_type`

`logo_thumbnail`

`swift_code` Premium only

`bank_codes` Premium only