Holidays
Public API

Get Catalog Holiday

Changed on

Gets a global holiday catalog entry by UUID.

OAuth Scopes: holidays

get/api/v1/holidays/catalog/{uuid}

Request

Path parameters

uuidstring uuid required

The catalog entry UUID.

Response

The catalog holiday.

uuidstring uuid

The catalog entry UUID. Use it to seed a company holiday from this catalog entry.

namestring

The holiday name

type'PUBLIC' | 'CULTURAL' | 'RELIGIOUS' | 'REGIONAL'

The holiday type

startDatestring date

The start date of the holiday

endDatestring date nullable

The end date of the holiday. Null for single-day catalog entries.

countryCodestring

ISO 3166-1 alpha-2 country code

sourcestring

The upstream catalog source

Example response

{
  "uuid": "f5a3b821-0c1e-4d39-9b7e-2c6d8a4f9e10",
  "name": "Independence Day",
  "type": "PUBLIC",
  "startDate": "2026-07-04",
  "endDate": "2026-07-05",
  "countryCode": "US",
  "source": "GoogleCalendar"
}

Changes