BAbamboohr
Account Information
Public API

List Bank Holidays

Changed on

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

get/api/v1/meta/bank-holidays

Request

Query parameters

yearinteger

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.

Response

Bank holidays retrieved successfully. Returns a JSON array of holiday objects sorted by date ascending; an empty array when no holidays match.

idinteger

Stable bank holiday identifier

namestring

Holiday display name

datestring date

Holiday date in YYYY-MM-DD form

Changes

  • 922fc15f43a7Revision changes
    • info

      api operation id get-bank-holidays removed and replaced with list-bank-holidays

    • info

      api tag Account Information added