List holiday requests
Holiday requests as the Holiday tab of Authorisations shows them.
GET https://cotlet.dev/api/v1/peoplehr/holiday-requests
read
Returns what the quick filters in Authorisations show: pending is the requests assigned to you as approver, all is every pending request in the company, decided is every decided request, my_requests is the ones set for you or already decided by you. Each request has the employee, dates, duration in days, the requester comment and the status. all and decided need an admin account.
Parameters
| Name | Type | Description |
|---|---|---|
| filter string | string | One of pending, all, decided, my_requests. Default pending. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/peoplehr/holiday-requests \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("peoplehr", "list_holiday_requests")const result = await cotlet.call('peoplehr', 'list_holiday_requests');cotlet call peoplehr list_holiday_requestsExample response
{
"requests": [
{
"request_id": "hol-48210",
"employee_id": "PW15",
"employee": "Priya Nair",
"start_date": "2026-11-16",
"end_date": "2026-11-18",
"duration_days": 3,
"requester_comment": "Long weekend with family",
"status": "Pending"
},
{
"request_id": "hol-48233",
"employee_id": "PW22",
"employee": "Lena Ortiz",
"start_date": "2026-12-01",
"end_date": "2026-12-10",
"duration_days": 8,
"requester_comment": "Family event",
"status": "Pending"
}
],
"next_cursor": null
}