Is it a business day?

GET /v1/days/{date}

Is this date a business day, in each calendar and combined?.

Use today as the date for the current day in tz.

Parameters

Name	In	Type	Default	Description
date (required)	path	string	—	YYYY-MM-DD, or today in the tz time zone
calendars (required)	query	string	—	Comma-separated calendar ids, at most 10, e.g. USD,AUD or XNYS,JP:bank
mode	query	all | any	all	all: a business day in every calendar (settlement). any: in at least one.
lang	query	string	en
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 bare value (see field)
field	query	is_business_day | is_holiday | is_early_close | close_time | status	is_business_day	With format=text, which value to return. All but is_business_day need exactly one calendar.

Example

curl "https://api.financecalendarapi.com/v1/days/2027-12-24?calendars=XNYS,USD"

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"
  },
  "date": "2027-12-24",
  "mode": "all",
  "is_business_day": false,
  "coverage": "verified",
  "calendars": [
    {
      "id": "XNYS",
      "status": "closed",
      "is_business_day": false,
      "close_time": null,
      "coverage": "verified",
      "entries": [
        {
          "date": "2027-12-24",
          "kind": "holiday",
          "name": "Christmas Day (observed)",
          "close_time": null,
          "status": "confirmed",
          "observed": true,
          "coverage": "verified"
        }
      ]
    },
    {
      "id": "USD",
      "status": "open",
      "is_business_day": true,
      "close_time": null,
      "coverage": "verified",
      "entries": []
    }
  ]
}

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