Get an approval request

Details of one request: dates, balance after approval, team overlap.

GET https://cotlet.dev/api/v1/personio/requests/{request_id}/approval-request

read

Returns what the request page shows. For time off: date range, whether it is open-ended, the remaining balance after approval, team members who are away on the same days, and the approval chain when there is more than one step. For employee data: the fields with old and new values.

Parameters

Parameters: get_approval_request
NameTypeDescription
request_id string required string Approval request ID from list_approval_requests.

Request

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

Example response

JSON

{
  "request_id": "apr_41c7e2",
  "kind": "time_off",
  "employee": "Maja Kowalska",
  "time_off_type": "Vacation",
  "start_date": "2026-11-03",
  "end_date": "2026-11-05",
  "days": 3,
  "open_ended": false,
  "balance_after": 15,
  "overlaps": [],
  "approval_chain": [
    "Tom Becker"
  ]
}

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.