---
title: "List Leave Policies Summary"
method: GET
path: "/v1/leave-policies/summary/{employment_id}"
tags: ["Leave Policies"]
---

# List Leave Policies Summary

`GET /v1/leave-policies/summary/{employment_id}`

List all the data related to time off for a given employment

## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage timeoffs (`time_and_attendance`) | View timeoffs (`timeoff:read`) | Manage timeoffs (`timeoff:write`) |

## Path parameters

- `employment_id` string, required

## Response `200`

Success

- ListLeavePoliciesSummaryResponse — Response schema for listing leave policies summary
  - `data` LeavePolicySummary[], required
    - `annual_balance` union, required — The annual balance represents the balance for the current entitlement period. Unlike the regular balance, it does not account for accrued value and only considers the annual entitlement as the basis for calculations.
      - UnlimitedDaysandHoursResponse
        - `type` 'unlimited', required
      - LimitedDaysandHoursResponse — Includes requested timeoffs (not approved) in the past or in the future.
        - `days` integer, required
        - `hours` integer, required
        - `type` 'limited', required
    - `annual_entitlement` union, required — The annual entitlement represents what an employee is entitled to in the current entitlement period. It does not account for any accrued value.
      - UnlimitedDaysandHoursResponse
        - `type` 'unlimited', required
      - LimitedDaysandHoursResponse — Includes requested timeoffs (not approved) in the past or in the future.
        - `days` integer, required
        - `hours` integer, required
        - `type` 'limited', required
    - `balance` union, required — The balance is the entitlement minus the taken timeoff (i.e 10 entitlement - 3 taken = 7 balance)
      - UnlimitedDaysandHoursResponse
        - `type` 'unlimited', required
      - LimitedDaysandHoursResponse — Includes requested timeoffs (not approved) in the past or in the future.
        - `days` integer, required
        - `hours` integer, required
        - `type` 'limited', required
    - `booked` object, required — Includes all upcoming requested time off.
      - `days` integer, required
      - `hours` integer, required
      - `type` 'limited', required
    - `current_entitlement` union, required — The current entitlement is the accrued time entitled for the employee plus any other extra entitlements (such as carryover).
      - UnlimitedDaysandHoursResponse
        - `type` 'unlimited', required
      - LimitedDaysandHoursResponse — Includes requested timeoffs (not approved) in the past or in the future.
        - `days` integer, required
        - `hours` integer, required
        - `type` 'limited', required
    - `leave_policy` EmployeeLeavePolicy, required — Leave Policy abstraction representation for the employee
      - `description` string, nullable, required
      - `leave_type` 'time_off' | 'sick_leave' | 'public_holiday' | 'unpaid_leave' | 'extended_leave' | 'in_lieu_time' | 'maternity_leave' | 'paternity_leave' | 'parental_leave' | 'bereavement' | 'military_leave' | 'other' | 'paid_time_off' | 'custom_company_leave' | 'rtt' | 'casual_leave' | 'rol' | 'ex_festivita', required
      - `name` string, required
      - `unit` 'days' | 'hours' | 'unlimited', required
    - `pending_approval` object, required — Includes requested timeoffs (not approved) in the past or in the future.
      - `days` integer, required
      - `hours` integer, required
      - `type` 'limited', required
    - `taken` object, required — Includes all time off (past and future, pending or approved).
      - `days` integer, required
      - `hours` integer, required
      - `type` 'limited', required
    - `upcoming_approved` object, required — Includes all upcoming approved time off.
      - `days` integer, required
      - `hours` integer, required
      - `type` 'limited', required
    - `upcoming_requested` object, required — Includes all upcoming requested time off.
      - `days` integer, required
      - `hours` integer, required
      - `type` 'limited', required
    - `used` object, required — Includes only approved time off in the past.
      - `days` integer, required
      - `hours` integer, required
      - `type` 'limited', required
    - `working_hours_per_day` integer, required

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/versions/7e6a0c61ac82/schema)