Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Holiday calendar data

Get holiday calendar

Get a holiday calendar

get/v1/holiday-calendar/{holiday_calendar_id}

Path parameters

holiday_calendar_idstring required
Example:8675309

Holiday calendar ID

Response

OK

external_idstring

Customer-provided external ID field for customer monitoring and tracking.

holiday_calendar_idinteger

Holiday calendar ID

metadatastring

Any data object with key/value pairs. No limit on length.

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

namestring

Holiday calendar name. Must be unique per organization.

parent_idinteger

Calendar parent ID.

Holiday calendars can have parent-child relationships, creating a hierarchy. Child calendars inherit holidays from their parent calendars.

Common use case: Country → State → City hierarchy

Example:

  • Brazil (parent)
    • São Paulo (child of Brazil)
      • Campinas (child of São Paulo)

When you query holidays for Campinas, you automatically get:

  • Campinas city holidays
  • São Paulo state holidays
  • Brazil national holidays

You can reference the parent calendar using either:

  • parent_id: The internal parent calendar ID
  • parent_external_id: The parent calendar external_id
typestring

Type, free-form field. For example, Country or Region.

working_daysinteger[]

Working days array

1 = Monday, 6 = Saturday. Default = [1, 2, 3, 4, 5].

Example response

{
  "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
  ]
}