Skip to content
Finance Calendar API

Calendar detail

GET /v1/calendars/{id}

Calendar detail, with the sources behind its verified dates.

Append .ics to the id (e.g. /v1/calendars/USD.ics?from=2026&to=2027) for an iCalendar feed.

Parameters

NameInTypeDefaultDescription
id (required)pathstring—

Example

Terminal window
curl "https://api.financecalendarapi.com/v1/calendars/XNYS"

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"
  },
  "calendar": {
    "id": "XNYS",
    "kind": "exchange",
    "name": "New York Stock Exchange",
    "timezone": "America/New_York",
    "origin": "library",
    "data_years": [
      2000,
      2040
    ],
    "verified_years": [
      2024,
      2025,
      2026,
      2027,
      2028
    ],
    "last_verified_at": "2026-10-13",
    "sources": [
      {
        "id": "ice-nyse-carter-closure-2025",
        "url": "https://ir.theice.com/press/news-details/2024/The-New-York-Stock-Exchange-Will-Close-Markets-on-January-9-to-Honor-the-Passing-of-Former-President-Jimmy-Carter-on-National-Day-of-Mourning/default.aspx",
        "publisher": "Intercontinental Exchange (NYSE)",
        "type": "exchange",
        "years": [
          2025
        ],
        "fetch": "http",
        "watch": false,
        "calendars": [
          "XNYS"
        ],
        "archived": null
      },
      {
        "id": "nyse-holidays-trading-hours",
        "url": "https://www.nyse.com/trade/hours-calendars",
        "publisher": "New York Stock Exchange (Intercontinental Exchange)",
        "type": "exchange",
        "years": [
          2026,
          2027,
          2028
        ],
        "fetch": "http",
        "watch": true,
        "calendars": [
          "XNYS"
        ],
        "archived": {
          "fetched_at": "2026-10-13T02:21:30Z",
          "sha256": "79602f7be5a8f1d39c2b1cac4dd02c4c07f18cf9f92d70602834069154719bad"
        }
      },
  …

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