Holidays in a range

GET /v1/holidays

Holidays, early closes and weekend working days in a date range.

Parameters

Name	In	Type	Default	Description
calendars (required)	query	string	—	Comma-separated calendar ids, at most 10, e.g. USD,AUD or XNYS,JP:bank
lang	query	string	en	Name language; falls back to English
include	query	sources	—
kind	query	holiday | early_close | weekend_workday	—	Only entries of this kind
tz	query	string	UTC	IANA time zone that resolves today, e.g. America/New_York. Default UTC.
format	query	json | csv | text	json	text: one date per line, for one calendar (spreadsheet IMPORTDATA / WEBSERVICE)
from	query	string	—	Default: 1 January of the current year. Accepts today.
to	query	string	—	Inclusive. Default: 31 December of from's year
days	query	string	—	Instead of to: this many days starting at from, e.g. from=today&days=30

Example

curl "https://api.financecalendarapi.com/v1/holidays?calendars=XNYS&from=2027-11-01&to=2027-12-31"

Response, captured from the live API when this page was built:

{
  "data_release": {
    "id": "20261016T064343Z",
    "library_version": "0.106",
    "generated_at": "2026-10-16T06:45:33+00:00"
  },
  "from": "2027-11-01",
  "to": "2027-12-31",
  "calendars": [
    {
      "id": "XNYS",
      "name": "New York Stock Exchange",
      "entries": [
        {
          "date": "2027-11-25",
          "kind": "holiday",
          "name": "Thanksgiving Day",
          "close_time": null,
          "status": "confirmed",
          "observed": false,
          "coverage": "verified"
        },
        {
          "date": "2027-11-26",
          "kind": "early_close",
          "name": "Day after Thanksgiving Day (markets close at 1:00pm)",
          "close_time": "13:00",
          "status": "confirmed",
          "observed": false,
          "coverage": "verified"
        },
        {
          "date": "2027-12-24",
          "kind": "holiday",
          "name": "Christmas Day (observed)",
          "close_time": null,
          "status": "confirmed",
          "observed": true,
          "coverage": "verified"
        }
      ]
    }
  ]
}

Errors use problem details. Every response says which data release answered it, in data_release and the x-data-release header.