v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Holidays (deprecated)

List holidays with administrative division ancestors (deprecated)

DEPRECATED. Call the List holiday calendars endpoint instead.

This endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.

Return a paginated list of holidays registered for an administrative division, including those inherited from a parent division.

get/holidays-core/v1/holiday/administrative-division/{administrative_division_id}/ancestors

Path parameters

idinteger required

Administrative division ID.

Query parameters

pageinteger

Page number.

perPageinteger

Example:15

Items per page

order'ASC' | 'DESC'

Order to return items: ASC = ascending order, DESC = descending. Default is DESC.

orderBy'ID' | 'NAME'

Example:ID

Sort by ID or NAME. Default = ID.

begin_datestring required

Example:2025-01-01

Beginning date filter, format = yyyy-mm-dd

end_datestring required

Example:2025-01-30

End date filter, format = yyyy-mm-dd

Response

pagesinteger

Total number of result pages.

current_pageinteger

Current result page.

per_pageinteger

Maximum results per page.

total_itemsinteger

Total number of result items.

Example response

{
  "pages": 1,
  "current_page": 1,
  "per_page": 10,
  "total_items": 1,
  "items": [
    {
      "id": 84849,
      "name": "Scotland",
      "type": "State",
      "external_id": "8675309"
    }
  ]
}