List calendars

GET /v1/calendars

List calendars.

Parameters

Name	In	Type	Default	Description
kind	query	country | settlement | exchange | bond	—

Example

curl "https://api.financecalendarapi.com/v1/calendars?kind=settlement"

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"
  },
  "calendars": [
    {
      "id": "AED",
      "kind": "settlement",
      "name": "UAE dirham settlement (CBUAE, UAEFTS)",
      "timezone": "Asia/Dubai",
      "origin": "rule",
      "data_years": [
        2000,
        2040
      ],
      "verified_years": [],
      "last_verified_at": null,
      "sources": [
        "u-ae-public-holidays"
      ],
      "bases": [
        "AE"
      ],
      "weekend": [
        {
          "start": "2000-01-01",
          "days": [
            5,
            6
          ]
        },
        {
          "start": "2021-12-27",
          "days": [
            5,
            6,
            7
          ]
        },
        {
          "start": "2022-01-03",
          "days": [
            6,
            7
          ]
        }
      ]
    },
    {
      "id": "AUD",
      "kind": "settlement",
      "name": "Australian dollar settlement (RITS)",
      "timezone": "Australia/Sydney",
      "origin": "rule",
      "data_years": [
        2000,
        2040
      ],
  …

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