Get a request

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

GET https://cotlet.dev/api/v1/quinyx/requests/{request_id}/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.

Request

cURL
curl https://cotlet.dev/api/v1/quinyx/requests/request_8c41d2/approval-request \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("quinyx", "get_approval_request", {"request_id":"request_8c41d2"})
Node.js
const result = await cotlet.call('quinyx', 'get_approval_request', {"request_id":"request_8c41d2"});
CLI
cotlet call quinyx get_approval_request --data '{"request_id":"request_8c41d2"}'

Example response

JSON

{
  "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": []
}

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.