Skip to content

Changes feed

GET /v1/changes

Dates added, removed or modified by each release.

modified includes a date becoming verified. Page with cursor = the previous response's next_cursor.

Parameters

NameInTypeDefaultDescription
sincequerystring—A date (YYYY-MM-DD): releases published on or after it. Or a release id: releases after it. Default: the last 30 days.
calendarsquerystring—Comma-separated calendar ids, at most 10, e.g. USD,AUD or XNYS,JP:bank
limitquerystring100
cursorquerystring—

Example

Terminal window
curl "https://api.financecalendarapi.com/v1/changes?since=2026-01-01&limit=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"
},
"changes": [
{
"release_id": "20261014T120959Z",
"published_at": "2026-10-14T12:15:45Z",
"calendar_id": "AE",
"date": "2025-01-01",
"kind": "holiday",
"change_type": "modified",
"before": {
"date": "2025-01-01",
"kind": "holiday",
"names": {
"en": "New Year's Day",
"ar": "رأس السنة الميلادية",
"th": "วันขึ้นปีใหม่",
"ur_PK": "نئے سال کا دن"
},
"status": "confirmed",
"observed": false,
"close_time": null,
"origin": "library",
"coverage": "library",
"sources": []
},
"after": {
"date": "2025-01-01",
"kind": "holiday",
"names": {
"en": "New Year's Day",
"ar": "رأس السنة الميلادية",
"th": "วันขึ้นปีใหม่",
"ur_PK": "نئے سال کا دن"
},
"status": "confirmed",
"observed": false,
"close_time": null,
"origin": "library",
"coverage": "verified",
"sources": [
"dfm-eid-al-adha-2025",
"fahr-eid-al-fitr-2025",
"fahr-hijri-new-year-2025",
"fahr-national-day-2025",
"fahr-new-year-2025",
"fahr-prophets-birthday-2025",
"mohre-eid-al-adha-2025",
"u-ae-public-holidays"
]
}
},
{
"release_id": "20261014T120959Z",
"published_at": "2026-10-14T12:15:45Z",
"calendar_id": "AE",
…

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