DocumentationAPI Reference
API Reference

List Catalog Holidays

get
https://{companyDomain}.bamboohr.com/api/v1/holidays/catalog

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
^[A-Za-z]{2}$

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

integer

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

string

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

string
Defaults to startDate asc

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

integer
≥ 1
Defaults to 1

Page number.

integer
1 to 100
Defaults to 20

Page size.

Responses

Updated about 4 hours ago

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 4 hours ago