---
title: "Preview a time off request"
method: POST
path: "/v1/companies/{company_uuid}/time_off/requests/preview"
tags: ["Time Off Requests"]
---

# Preview a time off request

`POST /v1/companies/{company_uuid}/time_off/requests/preview`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/time_off/requests/preview`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_uuid/time_off/requests/preview/post.ts> (a function with typed inputs; its response is checked against the schema)

Preview a time off request to see balance impact before creating

scope: `time_off_requests:read`

## Path parameters

- `company_uuid` string, required

## Headers

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

## Request body

- object
  - `request_uuid` string: The UUID of an existing time off request to preview changes for
  - `employee_uuid` string, required: The UUID of the employee
  - `policy_uuid` string, required: The UUID of the time off policy
  - `start_date` string, required: The start date of the time off request (YYYY-MM-DD)
  - `end_date` string, required: The end date of the time off request (YYYY-MM-DD)
  - `days` object, required: An object where keys are dates in YYYY-MM-DD format and values are hours as string decimals (e.g. {"2025-01-20": "8.000"})

## Response `200`

successful

- EmbeddedTimeOffRequestPreview: Preview of the balance impact for a time off request before it is created or updated.
  - `balance_hours` string, nullable, required: The employee's current available balance hours for this policy. Null for unlimited policies.
  - `this_request_hours` string, required: The total hours for this time off request.
  - `other_requested_hours` string, required: Hours from other pending or approved requests for this policy.
  - `remaining_balance_hours` string, nullable, required: The projected balance after this request is applied. Null for unlimited policies.
  - `allow_negative_balance` boolean, required: Whether the time off policy allows a negative balance.
  - `unlimited` boolean, required: Whether the time off policy provides unlimited time off.

## Other responses

- `404`: Not Found

---

[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)