---
title: "List Catalog Holidays"
method: GET
path: "/api/v1/holidays/catalog"
tags: ["Holidays", "Public API"]
---

# List Catalog Holidays

`GET /api/v1/holidays/catalog`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/holidays/catalog`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `holidays`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/holidays/catalog/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Query parameters

- `countryCode` string
- `year` integer
- `filter` string
- `orderBy` string
- `page` integer
- `pageSize` integer

## Response `200`

A page of catalog holidays.

- object
  - `data` GlobalHolidayGlobalHolidayV1[]: Catalog holidays for the current page
    - `uuid` string, uuid: The catalog entry UUID. Use it to seed a company holiday from this catalog entry.
    - `name` string: The holiday name
    - `type` 'PUBLIC' | 'CULTURAL' | 'RELIGIOUS' | 'REGIONAL': The holiday type
    - `startDate` string, date: The start date of the holiday
    - `endDate` string, date, nullable: The end date of the holiday. Null for single-day catalog entries.
    - `countryCode` string: ISO 3166-1 alpha-2 country code
    - `source` string: The upstream catalog source
  - `_links` object: Pagination navigation links
    - `next` object, nullable: Link to the next page. Null on the last page.
      - `href` string: URL of the next page
    - `prev` object, nullable: Link to the previous page. Null on the first page.
      - `href` string: URL of the previous page
  - `meta` PaginationMetaData: A response object that contains pagination metadata.
    - `page` integer: The page number of the results.
    - `pageSize` integer: The number of items per page.
    - `totalPages` integer: The total number of pages available.
    - `totalItems` integer: The total number of items available.

## Other responses

- `401`: Unauthorized. Missing or invalid authentication.
- `403`: Forbidden. Insufficient permissions.
- `422`: Invalid query parameter.

## Changes

- **2026-11-03** `922fc15f43a7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/holidays/catalog/get.md)

---

[API](https://skmtc.dev/bamboohr/apis/bamboohr-api.md) - [All operations](https://skmtc.dev/bamboohr/apis/bamboohr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)