# Oyster HR Time Off API

**Canonical:** https://apis.io/apis/oyster-hr/oyster-hr-time-off-api/  
**Provider:** Oyster HR — https://apis.io/providers/oyster-hr/  
**Base URL:** https://api.oysterhr.com/v1  
**Documentation:** https://www.oysterhr.com/developer-api

Oyster HR Time Off API is one of 24 APIs that [Oyster HR](https://apis.io/providers/oyster-hr/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 7 JSON Schema definitions. Tagged areas include Time Off. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 7 JSON Schemas.

With the Time Off API, you can manage your team's time off requests. You can approve or decline specific time off requests, access information about a particular request, and get updates on all time off requests. It also provides details on time off entitlements for each engagement within the company

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/public_holidays` | Retrieve public holidays |
| GET | `/v1/time_off/entitlements` | Retrieve entitlements |
| GET | `/v1/time_off/entitlements/{id}` | Retrieve entitlements for individual engagement |
| GET | `/v1/time_off/requests` | Retrieve all requests |
| POST | `/v1/time_off/requests` | Create time off request |
| GET | `/v1/time_off/requests/{id}` | Retrieve an individual request |
| POST | `/v1/time_off/requests/{id}/approve` | Approve request |
| POST | `/v1/time_off/requests/{id}/attachment` | Upload Time Off Request Attachment |
| POST | `/v1/time_off/requests/{id}/cancel` | Cancel request |
| POST | `/v1/time_off/requests/{id}/reject` | Reject request |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/oyster-hr/refs/heads/main/openapi/oyster-hr-time-off-api-openapi.yml
- **Documentation** — https://docs.oysterhr.com/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/oyster-hr/refs/heads/main/json-schema/oyster-hr-token-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/oyster-hr/refs/heads/main/json-schema/oyster-hr-employment-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/oyster-hr/refs/heads/main/json-schema/oyster-hr-contract-change-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/oyster-hr/refs/heads/main/json-schema/oyster-hr-employment-cost-estimate-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/oyster-hr/refs/heads/main/json-schema/oyster-hr-engagement-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/oyster-hr/refs/heads/main/json-schema/oyster-hr-time-tracking-time-sheet-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/oyster-hr/refs/heads/main/json-schema/oyster-hr-time-tracking-time-sheets-schema.json

## Other Oyster HR APIs (12)

- [Oyster HR Authentication API](https://apis.io/apis/oyster-hr/oyster-hr-authentication-api/)
- [Oyster HR Bank Accounts API](https://apis.io/apis/oyster-hr/oyster-hr-bank-accounts-api/)
- [Oyster HR Benefits API](https://apis.io/apis/oyster-hr/oyster-hr-benefits-api/)
- [Oyster HR Company API](https://apis.io/apis/oyster-hr/oyster-hr-company-api/)
- [Oyster HR Consent API](https://apis.io/apis/oyster-hr/oyster-hr-consent-api/)
- [Oyster HR Contract Changes API](https://apis.io/apis/oyster-hr/oyster-hr-contract-changes-api/)
- [Oyster HR Cost Estimate API](https://apis.io/apis/oyster-hr/oyster-hr-cost-estimate-api/)
- [Oyster HR Credit notes API](https://apis.io/apis/oyster-hr/oyster-hr-credit-notes-api/)
- [Oyster HR Departments API](https://apis.io/apis/oyster-hr/oyster-hr-departments-api/)
- [Oyster HR Employments API](https://apis.io/apis/oyster-hr/oyster-hr-employments-api/)
- [Oyster HR Engagements API](https://apis.io/apis/oyster-hr/oyster-hr-engagements-api/)
- [Oyster HR Expenses API](https://apis.io/apis/oyster-hr/oyster-hr-expenses-api/)

## Tags

Time Off

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/oyster-hr/oyster-hr-time-off-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/oyster-hr/.