List requests waiting for approval
List the requests in your Needs Approval inbox in the Schedule notifications panel.
GET https://cotlet.dev/api/v1/quinyx/approval-requests
read
Returns request_id, category, employee, a one-line summary and when it was sent. These are the same five categories as the Needs Approval section of the panel. You see only the requests Quinyx sends to your account, so the list depends on your role and permissions. Pass a request_id to get_approval_request for the full request.
Parameters
| Name | Type | Description |
|---|---|---|
| category string | string | One of absence_request, shift_booking, shift_swap, shift_unassignment_request, shift_assignment_away_unit. Default all. |
| group_id string | string | Only requests of this unit or section. |
Request
curl https://cotlet.dev/api/v1/quinyx/approval-requests \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("quinyx", "list_approval_requests")const result = await cotlet.call('quinyx', 'list_approval_requests');cotlet call quinyx list_approval_requestsExample response
{
"requests": [
{
"request_id": "77310",
"category": "absence_request",
"employee": "Elena Ruiz",
"summary": "Absence 4 to 5 Nov 2026",
"sent_at": "2026-10-21T16:40:00Z"
},
{
"request_id": "77318",
"category": "shift_swap",
"employee": "Sam Okafor",
"summary": "Swap Opening 28 Oct for Closing 29 Oct with Tom Becker",
"sent_at": "2026-10-22T08:05:00Z"
}
]
}