---
title: "List Time Off Policies"
method: GET
path: "/api/v1/meta/time_off/policies"
tags: ["Time Off", "Public API"]
---

# List Time Off Policies

`GET /api/v1/meta/time_off/policies`

Returns all non-deleted time off policies for the company, sorted alphabetically by name. Only includes policies whose time off type has not been deleted.

OAuth Scopes: time_off

## Headers

- `AcceptHeaderParameter` 'application/xml' | 'application/json'

## Response `200`

A list of all non-deleted time off policies, sorted alphabetically by name.

- object[]
  - `id` integer — The policy ID.
  - `timeOffTypeId` integer — The ID of the time off type this policy belongs to.
  - `name` string — The policy name.
  - `effectiveDate` string, nullable — Deprecated. Always null.
  - `type` 'accruing' | 'discretionary' | 'manual' — The policy type.

## Other responses

- `401` — Unauthorized. Invalid API credentials.
- `403` — Insufficient permissions to view time off policies.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)