Next holidays

GET /v1/holidays/next

The next N holidays and early closes from a date.

complete is false when the calendar's data ends before N entries are found.

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	today	Start date, inclusive. Default: today in tz
n	query	string	10

Example

curl "https://api.financecalendarapi.com/v1/holidays/next?calendars=XLON&from=2027-01-01&n=3"

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-01-01",
  "calendars": [
    {
      "id": "XLON",
      "name": "London Stock Exchange",
      "complete": true,
      "entries": [
        {
          "date": "2027-01-01",
          "kind": "holiday",
          "name": "New Year's Day",
          "close_time": null,
          "status": "confirmed",
          "observed": false,
          "coverage": "verified"
        },
        {
          "date": "2027-03-26",
          "kind": "holiday",
          "name": "Good Friday",
          "close_time": null,
          "status": "confirmed",
          "observed": false,
          "coverage": "verified"
        },
        {
          "date": "2027-03-29",
          "kind": "holiday",
          "name": "Easter Monday",
          "close_time": null,
          "status": "confirmed",
          "observed": false,
          "coverage": "verified"
        }
      ]
    }
  ]
}

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