List approval requests

Requests waiting for you in the Personio Inbox.

GET https://cotlet.dev/api/v1/personio/approval-requests

read

Returns the approval tasks in your Inbox: time off, attendance and employee data change requests, oldest first. Only requests you are an approver for appear, including ones delegated to you. Filter by kind to get only time off. Pages hold up to 50 items; pass next_cursor back as cursor.

Parameters

Parameters: list_approval_requests
NameTypeDescription
kind string string 'time_off', 'attendance' or 'employee_data'. Default all.
cursor string string Next page cursor from the previous call.

Request

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

Example response

JSON

{
  "requests": [
    {
      "request_id": "apr_41c7e2",
      "kind": "time_off",
      "employee": "Maja Kowalska",
      "summary": "Vacation, 2026-11-03 to 2026-11-05",
      "submitted_at": "2026-10-15T08:12:00Z"
    }
  ],
  "next_cursor": null
}

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.