List Employee Time Off Policies

get

https://{companyDomain}.bamboohr.com/api/v1/employees/{employeeId}/time-off/policies

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

employeeId

integer

required

The employee ID.

Query Params

filter

string

OData filter expression applied to the employee's policy assignments. Supported operators: eq (equals, use eq null to match NULL), ne (not equals, use ne null to match NOT NULL), lt (less than), le (less than or equal), gt (greater than), ge (greater than or equal), in (value in list), and (combine clauses). Not supported: or, not, parenthesized grouping. Filterable fields: policyId, categoryId. Examples: policyId eq 15, categoryId in (62, 64), categoryId eq 64 and policyId eq 15.

page

integer

≥ 1

Defaults to 1

The page number to retrieve. Rejected when the resulting offset would exceed the largest supported integer.

pageSize

integer

10 to 100

Defaults to 50

The number of items to return per page.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

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

401Unauthorized. The credentials are missing or invalid.

403Forbidden. The authenticated user may not view this employee's time off.

404Employee not found.

422Invalid query parameters (e.g. invalid page, pageSize, or an unsupported filter field).