NewConnect Claude, Cursor, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Bank Holidays API

The Bank Holidays API returns the days on which banks and financial institutions are officially closed across over 230 countries, regions, and territories around the world. The endpoints are dedicated to banking-relevant closures only — every entry is of type BANK_HOLIDAY.

Common use cases include:

  • Settlement and clearing calendars (ACH, wire, SWIFT)
  • Treasury and cash management systems
  • Trading and brokerage platforms
  • International payment scheduling
  • Loan amortization and interest accrual calendars

Available endpoints:

For other holiday categories — public, religious, observances, and more — see the Holidays API.

(4.1)

From 2,430 users

2,400+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
365ms399ms406ms733ms1213ms

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

/v1/bankholidays GET

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

Returns a list of bank holiday entries for a given country and year. Each entry contains the holiday name, date, day of the week, and country information.

Parameters

  • country  required

    Country name or ISO 3166-2 country code (preferred).

  • year  optional premium only

    Calendar year between 1980 and 2050 (inclusive). Defaults to the current year.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • name

    Name of the bank holiday.

  • date

    Date of the bank holiday in YYYY-MM-DD format.

  • country

    2-letter ISO 3166 alpha-2 country code.

  • year

    The year for which the bank holiday is observed.

Sample Request Live Demo!

country
year premium

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/bankholidays?country=US

Headers

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

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/bankholidays?country=US&year=2025" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

/v1/isbankholiday GET

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

Returns whether a given date is a bank holiday for a given country.

Parameters

  • date  required

    Date in YYYY-MM-DD format (e.g. 2025-12-25). Note: dates in future calendar years are for premium subscribers only.

  • country  required

    Country name or ISO 3166-2 country code (preferred).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • is_bank_holiday

    Whether the date is a bank holiday in the specified country.

  • bank_holiday_name

    Name of the bank holiday, when is_bank_holiday is true; otherwise null.

  • date

    Date in YYYY-MM-DD format.

  • country

    2-letter ISO 3166 alpha-2 country code.

Sample Request Live Demo!

date
country

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/isbankholiday?date=2025-01-01&country=US

Headers

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

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/isbankholiday?date=2025-01-01&country=US" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Bank Holidays by Country

Browse bank holidays for the world's most populous countries: