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

# Time-Off Events

`GET /employer/time-off-events`

**Beta:** This endpoint is in beta and may change.
Read time-off requests, approvals, and taken time-off

## Query parameters

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

## Headers

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

## Response `200`

Time-off events for employees

- TimeOffEvent[] — Array of time-off events for employees.
  - `id` string, uuid, required — Unique identifier for the time-off event.
  - `source_id` string, nullable, required — The provider's unique identifier for this time-off event.
  - `individual_id` string, uuid, required — A stable Finch `id` (UUID v4) for an individual in the company.
  - `reviewer_id` string, uuid, nullable, required — The ID of the employee who reviewed/approved this request.
  - `status` 'requested' | 'approved' | 'declined' | 'cancelled' | 'deleted', required — The status of the time-off request.
  - `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.
  - `event_type` 'vacation' | 'sick' | 'personal' | 'jury_duty' | 'volunteer' | 'bereavement' | 'other', required — The specific type of time-off event.
  - `source_event_type` string, required — The raw event type as defined by the provider.
  - `start_date` string, date-time, nullable, required — ISO 8601 datetime format (YYYY-MM-DDTHH:MM:SS). Default timestamps for start_date and end_date are 00:00:00 (beginning of day) and 23:59:59 (end of day), respectively. Note: Datetime values are represented in the timezone they are reflected in the provider.
  - `end_date` string, date-time, nullable, required — ISO 8601 datetime format (YYYY-MM-DDTHH:MM:SS). Default timestamps for start_date and end_date are 00:00:00 (beginning of day) and 23:59:59 (end of day), respectively. Note: Datetime values are represented in the timezone they are reflected in the provider.

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