---
title: "Get time off balances for a company"
method: GET
path: "/v1/companies/{company_uuid}/time_off/balances"
tags: ["Time Off Requests"]
---

# Get time off balances for a company

`GET /v1/companies/{company_uuid}/time_off/balances`

## Request

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

Get time off balances for all employees in a company

scope: `time_off_requests:read`

## Path parameters

- `company_uuid` string, required

## Query parameters

- `employee_uuids` string
- `policy_uuids` string
- `page` integer
- `per` integer

## Headers

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

## Response `200`

successful

- EmbeddedTimeOffBalance[]
  - `employee_uuid` string: The UUID of the employee.
  - `balances` object[]: The employee's time off balances, one entry per policy.
    - `policy_uuid` string: The UUID of the time off policy.
    - `balance_hours` string: The employee's current available balance hours for this policy.
    - `accrued_hours` string: The total hours accrued year-to-date for this policy.
    - `used_hours` string: The total hours used year-to-date for this policy.
    - `pending_hours` string, nullable: The total hours from pending time off requests for this policy.

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