---
title: "List Employee Leave Policies Summary"
method: GET
path: "/v1/employee/leave-policies/summary"
tags: ["Leave Policies"]
---

# List Employee Leave Policies Summary

`GET /v1/employee/leave-policies/summary`

List the leave policies summary (balances and entitlements) for the current employee

## Scopes

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

## 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

---

[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/revisions/7e6a0c61ac82/schema)