DocumentationAPI Reference
API Reference

List Bank Holidays

get
https://{companyDomain}.bamboohr.com/api/v1/meta/bank-holidays

Returns global bank holiday reference dates (US federal and related bank holidays maintained by BambooHR), not company-configured holidays. The response is a JSON array of holiday objects sorted by date in ascending order. Provide year to return only holidays whose dates fall within that calendar year; omit it to return the full multi-year reference set.

OAuth Scopes: meta

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
1 to 9999

When set, only holidays whose dates fall in this calendar year are returned. When omitted, all bank holidays are returned. Values outside 1-9999 return 422.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 14 hours ago

Language
Credentials
OAuth2
Missing 1 required scope
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated about 14 hours ago