---
title: "List time off entries"
method: GET
path: "/time-off/entries"
---

# List time off entries

`GET /time-off/entries`

## Request

- Base URL: `https://sandbox.checkhq.com`
- URL: `https://sandbox.checkhq.com/time-off/entries`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkhq/apis/check-api/docs/time-off/entries/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of time off entries. Filter by assignment or employee to show a statement of an employee's accrual and spend.

## Query parameters

- `company` string
- `employee` string
- `assignment` string
- `policy` string
- `payroll` string
- `source` string
- `limit` integer
- `id` string[]

## Response `200`

200

- object
  - `next` string, nullable
  - `previous` string, nullable
  - `results` TimeOffEntry[]
    - `id` string: Unique identifier for the entry.
    - `assignment` string: ID of the assignment whose balance the entry changes.
    - `policy` string: ID of the assignment's policy.
    - `policy_name` string: Name of the assignment's policy.
    - `employee` string: ID of the assignment's employee.
    - `hours` string, decimal: The change to the balance, in hours. Positive values are accrued; negative values are spent.
    - `source` 'payroll' | 'annual_grant' | 'expiration' | 'manual': How the entry was created. `payroll` entries come from accrual or hours spent on a payroll; `annual_grant` entries from the lump sum granted at the start of a policy year; `expiration` entries from unused hours above `max_rollover` expiring at the end of a policy year; and `manual` entries were created through the API.
    - `payroll` string, nullable: ID of the payroll that created the entry, if `source` is `payroll`.
    - `created_at` string, date-time: When the entry was created.
    - `metadata` object: Additional loosely structured information to associate with the object.

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `5a54f5eb888b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/checkhq/apis/check-api/changes/time-off/entries/get.md)

---

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