# Oyster HR Engagements API

**Canonical:** https://apis.io/apis/oyster-hr/oyster-hr-engagements-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 Engagements 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 Engagements. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 7 JSON Schemas.

The Engagements API from Oyster HR — 6 operation(s) for engagements.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/engagements` | Retrieve all engagements |
| GET | `/v1/engagements/{id}` | Retrieve an individual engagement |
| GET | `/v1/engagements/{id}/allowances` | Retrieve allowances for engagement |
| GET | `/v1/engagements/{id}/bonuses` | Retrieve bonuses for engagement |
| GET | `/v1/engagements/{id}/documents` | Retrieve documents for engagement |
| GET | `/v1/engagements/{id}/payslips` | Retrieve payslips for engagement |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/oyster-hr/refs/heads/main/openapi/oyster-hr-engagements-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 Expenses API](https://apis.io/apis/oyster-hr/oyster-hr-expenses-api/)
- [Oyster HR Identity Verification API](https://apis.io/apis/oyster-hr/oyster-hr-identity-verification-api/)

## Tags

Engagements

---

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