v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Holiday Pay Policies

Preview a company's paid holidays

Preview a company's paid holidays

If a year is passed, paid holidays for that year will be returned. Otherwise, paid holidays for the next three years will be returned.

scope: holiday_pay_policies:read

get/v1/companies/{company_uuid}/paid_holidays

Path parameters

company_uuidstring required

The UUID of the company

Query parameters

yearstring
Example:2023

If a year is passed, paid holidays for that year will be returned. Otherwise, paid holidays for the next three years will be returned.

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

successful

holiday_keystring nullable

The holiday's identifier (null for custom holidays)

holiday_namestring

The holiday's official name

start_datestring

The holiday's start date (YYYY-MM-DD)

end_datestring

The holiday's end date (YYYY-MM-DD)