---
title: "List of employee leave balances"
method: GET
path: "/employees/{employee_id}/leave_balances"
tags: ["Leaves"]
---

# List of employee leave balances

`GET /employees/{employee_id}/leave_balances`

## Request

- Base URL: `https://app.peopleforce.io/api/public/v3`
- URL: `https://app.peopleforce.io/api/public/v3/employees/{employee_id}/leave_balances`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/peopleforce/apis/company-api/docs/employees/:employee_id/leave_balances/get.ts> (a function with typed inputs; its response is checked against the schema)

Return a list of employee leave types and balances for each

## Response `200`

OK

- object
  - `data` EmployeeLeaveType[]
    - `effective_on` string, date
    - `balance` number
    - `leave_type_policy` LeaveTypePolicy
      - `id` integer
      - `name` string
      - `activity_type` 'not_working_paid' | 'not_working_unpaid' | 'working_paid'
      - `counted_as` 'working_days' | 'calendar_days'
      - `leave_type_id` integer
      - `visibility` boolean
      - `type` 'accrual' | 'manual' | 'external'
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `leave_type` LeaveType
      - `id` integer
      - `name` string
      - `unit` string
      - `hex_color` string
      - `fa_class` string
      - `created_at` string, date-time
    - `id` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time

---

[API](https://skmtc.dev/peopleforce/apis/company-api.md) - [All operations](https://skmtc.dev/peopleforce/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peopleforce/apis/company-api/revisions/ff612e61a4c3?raw)