BAbamboohr
Holidays
Public API

List Catalog Holidays

Changed on

Lists entries in the global holiday catalog. The catalog is read-only system reference data; use the returned uuid values to seed company holidays.

OAuth Scopes: holidays

get/api/v1/holidays/catalog

Request

Query parameters

countryCodestring

ISO 3166-1 alpha-2 country code. Filters the catalog to entries for the given country.

yearinteger

Calendar year. Filters the catalog to entries whose startDate falls in the given year.

filterstring

OData v4 filter expression. Supported fields: name, type, countryCode, startDate. Example: startDate ge '2026-01-01' and type eq 'PUBLIC'

orderBystring

Sort expression. Allowed fields: startDate, name, with optional asc/desc direction.

pageinteger

Page number.

pageSizeinteger

Page size.

Response

A page of catalog holidays.

Example response

{
  "data": [
    {
      "uuid": "f5a3b821-0c1e-4d39-9b7e-2c6d8a4f9e10",
      "name": "Independence Day",
      "type": "PUBLIC",
      "startDate": "2026-07-04",
      "endDate": "2026-07-05",
      "countryCode": "US",
      "source": "GoogleCalendar"
    }
  ],
  "meta": {
    "pageSize": 100,
    "totalPages": 1,
    "totalItems": 10
  }
}

Changes