List Company Holidays

get

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

Returns a paginated list of active company holidays. Soft-deleted holidays are never returned. Supports OData filtering via filter, sorting via orderBy, field projection via select, and page-based pagination.

OAuth Scopes: holidays

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

filter

string

OData filter expression applied to company holidays. Supported operators: eq (equals, use eq null to match NULL), ne (not equals, use ne null to match NOT NULL), lt (less than), le (less than or equal), gt (greater than), ge (greater than or equal), in (value in list), and (combine clauses). Not supported: or, not, parenthesized grouping. Filterable fields: name, startDate, endDate, isPublic, globalHolidayUuid. Examples: startDate ge '2026-01-01', isPublic eq true and endDate ne null.

orderBy

string

Defaults to startDate asc

Comma-separated list of sort terms, each a field optionally followed by asc or desc. Allowed sort fields: name, startDate, endDate, createdAt, updatedAt.

select

string

Comma-separated list of properties to include in each returned holiday. Reduces payload size. Example: id,name,startDate.

page

integer

≥ 1

Defaults to 1

The page number to retrieve.

pageSize

integer

1 to 100

Defaults to 20

The number of items to return per page.

Responses

200A paginated list of company holidays.

401Unauthorized. Missing or invalid authentication.

403Forbidden. Insufficient permissions.

422Invalid query parameter (bad page or pageSize, unsupported filter/sort/select field, or malformed filter expression).