FAfactorialhr
Holidays > CompanyHoliday

Reads a single Company holiday

Changed on

Retrieves company holidays

get/api/2026-10-01/resources/holidays/company_holidays/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/holidays/company_holidays/{id}
  • 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

Path parameters

idstring required

Return only the company holidays with these ids.

Response

OK

idstring required

Company holiday id

location_idstring required

Related location id

summarystring

Company holiday summary

descriptionstring

Company holiday description

datestring required

Company holiday date

half_day'beginning_of_day' | 'end_of_day'

If the company holiday is half-day and which part of the day

Example response

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

Changes