FAfactorialhr
Holidays > CompanyHoliday

Reads all Company holidays

Changed on

Retrieves company holidays

get/api/2026-10-01/resources/holidays/company_holidays

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/holidays/company_holidays
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: company_holidays
    • or API key in header x-api-key

Query parameters

ids[]string[]

Return only the company holidays with these ids.

[
  "56"
]
location_ids[]string[]

Return only the holidays declared for these locations. A company holiday always belongs to exactly one location.

[
  "1"
]
team_ids[]string[]

Return only the holidays of the locations that are the default workplace of somebody in these teams. It reaches teams through employees, not directly.

[
  "3"
]
employee_ids[]string[]

Filter by the default location of these employees

[
  "1"
]
start_atstring

Return only the holidays falling on or after this date. Usable on its own, as an open-ended lower bound.

Example:2024-12-01
end_atstring

Return only the holidays falling on or before this date. Usable on its own, as an open-ended upper bound.

Example:2024-12-31

Response

OK

Example response

{
  "data": [
    {
      "id": "56",
      "location_id": "1",
      "summary": "Christmas Day",
      "description": "Christmas Day",
      "date": "2024-12-25"
    }
  ]
}

Changes