---
title: "List Employee Time Off Policies"
method: GET
path: "/api/v1/employees/{employeeId}/time-off/policies"
tags: ["Time Off", "Public API"]
---

# List Employee Time Off Policies

`GET /api/v1/employees/{employeeId}/time-off/policies`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/employees/{employeeId}/time-off/policies`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `time_off:policies`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/employees/:employeeId/time-off/policies/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the time off policies assigned to an employee, with support for filtering and pagination. Ordered by effective date descending, so the most recent assignment is first. Only active assignments are returned; the archived and superceded rows the server keeps to track reassignment history are not surfaced. An active assignment may carry a past `endDate`: it remained in force up to that date and still contributes to historical accrual.

OAuth Scopes: time_off:policies

## Path parameters

- `employeeId` integer, required

## Query parameters

- `filter` string
- `page` integer
- `pageSize` integer

## Response `200`

A paginated list of the employee's active time off policy assignments.

- object
  - `data` EmployeeTimeOffPolicyAssignmentV1[]: Collection of employee time off policy assignments
    - `id` integer: The unique identifier for the policy assignment.
    - `employeeId` integer: The id of the employee the policy is assigned to.
    - `policyId` integer: The id of the assigned time off policy.
    - `categoryId` integer: The id of the time off category the assigned policy belongs to. Denormalized so callers do not need a second request to resolve the policy.
    - `effectiveDate` string, date, nullable: The date the assignment takes effect, in ISO 8601 format (YYYY-MM-DD). For accruing policies this is the accrual basis date.
    - `endDate` string, date, nullable: The date the assignment ends, in ISO 8601 format (YYYY-MM-DD). Null when the assignment is open ended. Read-only; the server manages it when a successor assignment supersedes this one.
    - `createdAt` string, date-time, nullable: UTC timestamp when the assignment was created.
    - `updatedAt` string, date-time, nullable: UTC timestamp when the assignment was last updated. Null when the assignment has never been updated.
    - `status` 'ACTIVE' | 'ARCHIVED' | 'SUPERSEDED': The assignment's lifecycle state. ACTIVE assignments are the ones the list endpoint returns, including those whose `endDate` has passed: an ended assignment is still the record of the period it covered. ARCHIVED means the assignment is no longer in effect for any date: a later write starting on or before its effective date replaced or cancelled it, whether or not it had already taken effect. It is kept as history and never returns to the list. SUPERSEDED is the pre-change snapshot kept when an assignment is unassigned or its date or policy is changed; the successor row carries the change. Only ACTIVE appears in list responses; the other two appear inside `supersededAssignments` on the write response that produced them.
  - `meta` object
    - `page` integer
    - `pageSize` integer
    - `totalPages` integer
    - `totalItems` integer
  - `_links` object: Pagination links. `prev` is absent on the first page and `next` is absent on the last; neither is ever null.
    - `prev` object
      - `href` string
    - `next` object
      - `href` string

## Other responses

- `401`: Unauthorized. The credentials are missing or invalid.
- `403`: Forbidden. The authenticated user may not view this employee's time off.
- `404`: Employee not found.
- `422`: Invalid query parameters (e.g. invalid page, pageSize, or an unsupported filter field).

## Changes

- **2026-11-03** `922fc15f43a7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/employees/:employeeId/time-off/policies/get.md)

---

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