---
title: "Preview a company's paid holidays"
method: GET
path: "/v1/companies/{company_uuid}/paid_holidays"
tags: ["Holiday Pay Policies"]
---

# Preview a company's paid holidays

`GET /v1/companies/{company_uuid}/paid_holidays`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/paid_holidays`
- Auth: HTTP bearer

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`

## Path parameters

- `company_uuid` string, required

## Query parameters

- `year` string

## Headers

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

## Response `200`

successful

- PaidHoliday[]
  - `holiday_key` string, nullable: The holiday's identifier (null for custom holidays)
  - `holiday_name` string: The holiday's official name
  - `start_date` string: The holiday's start date (YYYY-MM-DD)
  - `end_date` string: The holiday's end date (YYYY-MM-DD)

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)