List time off requests
Time off requests with employee, policy type, dates and status, pending first.
GET https://cotlet.dev/api/v1/connecteam/time-off-requests
read
Returns the requests of the users your account can act on: users you manage directly or whose smart group you administer. status pending is the Pending Requests window, approved and declined show past decisions. Each row has request_id, employee, policy type, dates and days. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | pending (default), approved or declined. |
| start_date date | date | Only requests that end on or after this date. |
| end_date date | date | Only requests that start on or before this date. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/connecteam/time-off-requests \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("connecteam", "list_time_off_requests")const result = await cotlet.call('connecteam', 'list_time_off_requests');cotlet call connecteam list_time_off_requestsExample response
{
"requests": [
{
"request_id": "5528",
"user_id": 8821077,
"name": "Priya Nair",
"policy_type": "Vacation",
"start_date": "2026-10-22",
"end_date": "2026-10-23",
"days": 2,
"status": "pending"
},
{
"request_id": "5531",
"user_id": 8821090,
"name": "Marco Bell",
"policy_type": "Vacation",
"start_date": "2026-12-14",
"end_date": "2026-12-23",
"days": 8,
"status": "pending"
}
],
"next_cursor": null
}