List requests waiting for approval
List the requests in your Needs Approval inbox in the Schedule notifications panel.
MCP tool quinyx_read → list_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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "quinyx_read",
"arguments": {
"operation": "list_approval_requests",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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"
}
]
},
"isError": false
}