List leave requests
Pending leave requests with employee, dates, leave type and comment.
GET https://cotlet.dev/api/v1/deputy/leave-requests
read
Returns leave requests waiting for a decision, oldest first, with the employee, the first and last day, the leave type the employee picked and their comment. The leave type is only a suggestion. status approved or declined lists decided requests instead.
Parameters
| Name | Type | Description |
|---|---|---|
| location_id integer | integer | Location ID from list_locations. Default: all your locations. |
| status enum | enum | pending (default), approved or declined. |
Request
curl https://cotlet.dev/api/v1/deputy/leave-requests \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("deputy", "list_leave_requests")const result = await cotlet.call('deputy', 'list_leave_requests');cotlet call deputy list_leave_requestsExample response
{
"leave_requests": [
{
"leave_id": 311,
"employee": "Tom Becker",
"date_start": "2026-11-03",
"date_end": "2026-11-04",
"leave_type": "Annual leave",
"comment": "Family trip",
"status": "pending"
}
]
}