---
title: "Time-Off Balances"
method: GET
path: "/employer/time-off-balances"
tags: ["Time Off (Beta)"]
---

# Time-Off Balances

`GET /employer/time-off-balances`

**Beta:** This endpoint is in beta and may change.
Read employee time-off balances and accrual information

## Query parameters

- `individual_id` string, uuid
- `policy_type` 'pto' | 'sick' | 'parental' | 'unpaid' | 'other'

## Headers

- `Finch-API-Version` string, date, required

## Response `200`

Time-off balances for employees

- TimeOffBalance[] — Array of time-off balances for employees.
  - `individual_id` string, uuid, required — A stable Finch `id` (UUID v4) for an individual in the company.
  - `policy_type` 'pto' | 'sick' | 'parental' | 'unpaid' | 'other' | 'null', nullable, required — The type of time-off policy.
  - `source_policy_type` string, nullable, required — The raw policy type as defined by the provider.
  - `units` 'days' | 'hours' | 'minutes', required — The units for the time-off amount.
  - `used` integer, nullable, required — Total amount used for this policy.
  - `total` integer, nullable, required — Total amount allocated for this policy.

## Other responses

- `202` — The request has been accepted for processing, but data is not yet available

## Changes

- **2025-07-25** `73c284d36c1e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/employer/time-off-balances/get.md)

---

[API](https://skmtc.dev/finch-api/apis/api-reference.md) · [All operations](https://skmtc.dev/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/e8b684dbd61d/schema)