List time off requests

Time off requests with person, type, dates, days and status.

GET https://cotlet.dev/api/v1/charliehr/time-off-requests

read

Returns requests in the three groups the Time tab shows: pending, upcoming (approved) and past. The role decides what you see: everyone for an Admin or Super Admin, direct reports for a Line Manager, the team for a Team Lead. A custom approver sees the requests assigned to them. Sorted by start date.

Parameters

Parameters: list_time_off_requests
NameTypeDescription
status string string pending, upcoming or past
member_id string string Only this person
from string string Earliest start date, YYYY-MM-DD
to string string Latest start date, YYYY-MM-DD

Request

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

Example response

JSON

{
  "requests": [
    {
      "request_id": "tor_4f81c2",
      "member_id": "tm_52e1a9",
      "member": "Sam Rivera",
      "type": "Holiday",
      "start_date": "2026-11-02",
      "end_date": "2026-11-04",
      "days": 3,
      "status": "pending"
    },
    {
      "request_id": "tor_c3b5e8",
      "member_id": "tm_9b04f7",
      "member": "Leo Fischer",
      "type": "Holiday",
      "start_date": "2026-11-09",
      "end_date": "2026-11-09",
      "days": 1,
      "status": "pending"
    },
    {
      "request_id": "tor_9a07d1",
      "member_id": "tm_18c6d3",
      "member": "Priya Nair",
      "type": "Holiday",
      "start_date": "2026-11-16",
      "end_date": "2026-11-20",
      "days": 5,
      "status": "pending"
    }
  ]
}

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.