v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Holiday calendar data

List holiday calendars

List holiday calendars for an Organization.

get/v1/holiday-calendar

Query parameters

holiday_calendar_idinteger

Holiday calendar ID filter

namestring

Example:Independance Day

Holiday calendar name filter

typestring

Holiday calendar type filter

external_idstring

Client-created calendar holiday ID

parent_idinteger

Example:5

Holiday calendar parent ID filter

sort_by'name' | 'type'

Example:name

Sort field - name or type. Default is name.

sort_order'asc' | 'desc'

Sort order - asc or desc. Default is asc

relation'parents' | 'children'

Calendar relationship type. Default is all Organization calendars. Either external_id or holiday_calendar_id is REQUIRED if this field is passed.

pageinteger

Page number.

perPageinteger

Example:15

Items per page

Headers

x-tenantstring required

Organization/tenant ID

x-cidstring

The Correlation ID UUID field links related API requests and events. The x-cid can help the Pismo engineering team track everything related to a call. If not passed, this field is automatically generated.

Response

current_pageinteger

Current page number

pagesinteger

Number of pages

per_pageinteger

Maximum number of items per page

total_itemsinteger

Total number of items

Example response

{
  "current_page": 1,
  "pages": 10,
  "per_page": 15,
  "total_items": 100,
  "items": [
    {
      "external_id": "9erqwerncsodignlkd80we4ty",
      "holiday_calendar_id": 8675309,
      "metadata": "{ \"key\": \"value\"}",
      "name": "Brazil holiday calendar",
      "parent_id": 8675309,
      "type": "Country",
      "working_days": [
        1,
        2,
        3,
        4,
        5,
        6
      ]
    }
  ]
}