BAbamboohr
Holidays
Public API

Get Company Holiday

Changed on

Gets a company holiday by ID.

OAuth Scopes: holidays

get/api/v1/holidays/{id}

Request

Path parameters

idinteger required

The company holiday ID.

Response

The company holiday.

idinteger

The ID of the holiday

namestring

The name of the holiday

startDatestring date

The start date of the holiday

endDatestring date nullable

The end date of the holiday. Null for single-day holidays.

isPublicboolean

Whether the holiday is visible to all employees on calendars, independent of audience

countryCodesstring[]

Country filter as ISO 3166-1 alpha-2 codes. Empty means no country filter.

globalHolidayUuidstring uuid nullable

UUID of the global catalog entry this holiday was sourced from. Null for custom holidays.

createdAtstring date-time

ISO 8601 timestamp when the holiday was created

updatedAtstring date-time

ISO 8601 timestamp when the holiday was last updated

deletedAtstring date-time nullable

ISO 8601 timestamp when the holiday was soft-deleted. Null for active holidays.

Example response

{
  "id": 42,
  "name": "Independence Day",
  "startDate": "2026-07-04",
  "endDate": "2026-07-05",
  "countryCodes": [
    "US",
    "CA"
  ],
  "holidayPay": {
    "defaultHours": "8.00",
    "hoursByEmploymentStatus": [
      {
        "employmentStatusListValueId": 17946,
        "hours": "5.00"
      }
    ],
    "multiplier": "1.50"
  },
  "createdAt": "2026-04-30T18:00:00Z",
  "updatedAt": "2026-04-30T18:00:00Z"
}

Changes