Get a request

Read one request with the shifts it affects and what Quinyx warns about.

MCP tool quinyx_read → get_approval_request

read

Returns the period, the employee's comment and the shifts scheduled inside it. For an absence request it adds the holiday days left when the organization uses Time Trackers. For a shift booking or swap it lists the agreement rules the shift would break, the ones Quinyx marks with an exclamation mark.

Parameters

Parameters: get_approval_request
NameTypeDescription
request_id string required string Id from list_approval_requests.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quinyx_read",
    "arguments": {
      "operation": "get_approval_request",
      "arguments": {
        "request_id": "request_8c41d2"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "request_id": "77310",
    "category": "absence_request",
    "employee": "Elena Ruiz",
    "period": {
      "from": "2026-11-04",
      "to": "2026-11-05"
    },
    "employee_comment": "Family visit.",
    "shifts": [
      {
        "shift_id": "90412",
        "shift_type": "Opening",
        "start": "2026-11-04T06:00",
        "end": "2026-11-04T14:00"
      },
      {
        "shift_id": "90437",
        "shift_type": "Opening",
        "start": "2026-11-05T06:00",
        "end": "2026-11-05T14:00"
      }
    ],
    "time_tracker": {
      "holiday_days_left": 11
    },
    "warnings": []
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.