---
title: "Reads a single Leave"
method: GET
path: "/api/2026-10-01/resources/timeoff/leaves/{id}"
tags: ["Timeoff > Leave"]
---

# Reads a single Leave

`GET /api/2026-10-01/resources/timeoff/leaves/{id}`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/timeoff/leaves/{id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `time_off`
  - API key in header `x-api-key`

Reads a single Leave

## Path parameters

- `id` string, required

## Response `200`

OK

- TimeoffLeave
  - `id` string, required: Identifier of the Leave
  - `company_id` string, required: ID of the company the leave belongs to
  - `employee_id` string, required: ID of the employee taking the leave
  - `start_on` string, required: First day of the leave
  - `finish_on` string: Last day of the leave (inclusive); null while an open-ended leave has no end yet
  - `half_day` string: Which half of the day a half-day leave covers — `beginning_of_day` or `end_of_day`; null for full-day leaves
  - `description` string: Free-text description of the leave
  - `reason` string: The reason provided by the employee for taking the leave
  - `leave_type_id` string: ID of the leave type this leave is of
  - `leave_type_name` string: Denormalised name of the leave type
  - `approved` boolean: Tri-state approval status — true = approved, false = rejected, null = pending approval
  - `employee_full_name` string: The full name of the employee taking the leave
  - `start_time` string: The start time of the leave
  - `hours_amount_in_cents` integer: Total hours the leave consumes, in hundredths of an hour (e.g. 800 = 8 hours); set for hourly leaves
  - `updated_at` string, required: The updated at date of the leave
  - `created_at` string: The created at date of the leave
  - `deleted_at` string: The date when the leave was deleted
  - `duration_attributes` string: The duration attributes of the leave
  - `duration_by_day_attributes` object: Per-day breakdown of the leave's workable and used units, keyed by calendar date. Populated only when the read requests `include_duration_by_day=true`; null otherwise.
    - `workable_units_by_day` object, required
      - `days` unknown, required
      - `hours` unknown, required
    - `used_units_by_day` object, required
      - `days` unknown, required
      - `hours` unknown, required
  - `days_taken` number, required: Number of days taken for paid leave. Reflects the summed per-day used total when the per-day breakdown is computed; otherwise the leave's calendar-day duration.

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/timeoff/leaves/:id/get.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)