---
title: "time off taken"
method: GET
path: "/v{version}/companies/{company_id}/timeoff/requests"
tags: ["Company"]
---

# time off taken

`GET /v{version}/companies/{company_id}/timeoff/requests`

Returns a list of time off entries for a company, that fall on a specific date.<p>Scopes: export_hris, export_hris_timeoff</p>

## Path parameters

- `company_id` string, required
- `version` string, required

## Query parameters

- `status` string, required
- `start_date` string, required
- `end_date` string, required
- `paid_status` 'Any' | 'Paid' | 'Unpaid'
- `pay_group_id` string

## Response `200`

Success

- 0WrappedArrayTimeOffTaken
  - `data` DtosTimeOffTaken[], required — An array containing the list of relevant objects.
    - `employee_id` string, required — The employee id.
    - `type` 'Other' | 'Beareavement' | 'Civic Duty' | 'Civic Duty (Non-Exempt)' | 'Disability' | 'Family/Medical' | 'FMLA' | 'Floating Holiday' | 'Paid Time Off' | 'Parental' | 'Personal' | 'Medical' | 'Sick' | 'USERRA' | 'Vacation' | 'Work From Home', required — The type of time off request.
    - `hours` number, double, required — The hours taken.
  - `error` string — Contains any error messages, if applicable.

---

[API](https://skmtc.net/ease/apis/version-2.md) · [All operations](https://skmtc.net/ease/apis/version-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ease/version-2/revisions/be66ed178abe/schema)