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

Bank Holidays in United States

Bank holidays in the United States are days the Federal Reserve System is closed for business, meaning ACH, Fedwire, and most check-clearing operations do not run. The list includes 11 federal holidays such as New Year's Day, Martin Luther King Jr. Day, Memorial Day, Juneteenth, Independence Day, Labor Day, Thanksgiving, and Christmas Day. The Holidays API provides U.S. bank holiday data with full historical coverage and future calendars through 2039.

The United States Bank Holidays API allows you to:

  • List every American bank holiday for a given year
  • Pull historical United States bank holiday calendars going back to 1980
  • Build settlement, payroll and treasury calendars that respect United States financial closures
  • Integrate United States banking holidays into trading, brokerage, or scheduling systems
(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
391ms417ms453ms753ms1294ms

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

United States Bank Holidays 2025

The table below lists the United States bank holidays for 2025. Use the API to retrieve the full list for any year between 1980 and 2050.

DateDayHoliday
2025-01-01WednesdayNew Year's Day
2025-01-20MondayMartin Luther King Jr. Day
2025-02-17MondayPresidents' Day
2025-05-26MondayMemorial Day
2025-06-19ThursdayJuneteenth
2025-07-04FridayIndependence Day
2025-09-01MondayLabor Day
2025-11-27ThursdayThanksgiving Day
2025-12-25ThursdayChristmas Day

Sample 2025 schedule. Some dates — in particular religious dates that follow lunar or Coptic calendars — vary year to year. Call the live API for the authoritative list.

/v1/bankholidays GET

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

Returns every bank holiday observed in United States for the specified year. Use the country ISO code US to retrieve United States bank closures.

Parameters

  • country  required

    Country name or ISO 3166-2 country code. Use US for United States.

  • year  optional premium only

    Calendar year between 1980 and 2050. Defaults to the current year.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

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

  • name

    Name of the bank holiday.

  • date

    Date in YYYY-MM-DD format.

  • country

    ISO 3166 alpha-2 country code (e.g. US).

  • year

    Year of the bank holiday.

Sample Request Live Demo!

country
year premium

Try this endpoint live with a free API key

Instant access — no credit card required.

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
[
    {
      name:"New Year's Day",
      date:"2025-01-01",
      country:"US",
      year:2025
    },
    {
      name:"Martin Luther King Jr. Day",
      date:"2025-01-20",
      country:"US",
      year:2025
    },
    {
      name:"Presidents' Day",
      date:"2025-02-17",
      country:"US",
      year:2025
    },
    {
      name:"Memorial Day",
      date:"2025-05-26",
      country:"US",
      year:2025
    },
    {
      name:"Juneteenth",
      date:"2025-06-19",
      country:"US",
      year:2025
    },
    {
      name:"Independence Day",
      date:"2025-07-04",
      country:"US",
      year:2025
    },
    {
      name:"Labor Day",
      date:"2025-09-01",
      country:"US",
      year:2025
    },
    {
      name:"Thanksgiving Day",
      date:"2025-11-27",
      country:"US",
      year:2025
    },
    {
      name:"Christmas Day",
      date:"2025-12-25",
      country:"US",
      year:2025
    }
]

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 above, you can still make API calls by using any HTTP request library and following the documentation above.

Bank Holidays in Other Countries

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Bank Holidays API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • 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.
  • 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.
  • 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.
  • Because every entry is of type BANK_HOLIDAY (banking-relevant closures only), the API is well suited for settlement and clearing calendars (ACH, wire, SWIFT), treasury and cash management, trading platforms, international payment scheduling, and loan interest accrual calendars. For non-banking holidays such as public, religious, and observances, use the Holidays API instead.
  • Call the /v1/bankholidays endpoint with the required country parameter (a country name or, preferably, an ISO 3166-2 code) and an optional year between 1980 and 2050, which defaults to the current year and is a premium feature. To check a single date instead, see the /v1/isbankholiday endpoint, or for non-bank holidays try Public Holidays.
  • It returns a JSON object with is_bank_holiday (true or false), bank_holiday_name (the holiday name when true, otherwise null), the date in YYYY-MM-DD format, and the 2-letter country code, given the required date and country parameters. To find the actual business days around a closure, pair it with the Working Days API.
  • The API covers over 230 countries, regions, and territories, and each array entry includes the name of the bank holiday, its date in YYYY-MM-DD format, the 2-letter ISO 3166 alpha-2 country code, and the year observed. To validate or look up country codes, see the Country API.