List pending time off requests
Time off requests waiting for approval in your BambooHR inbox, or in the company inbox for admins.
GET https://cotlet.dev/api/v1/bamboohr/pending-time-off-requests
read
Returns the time off requests in the Time Off Requests section of the inbox that wait for a decision. Scope assigned_to_me lists requests where you are the next approver; assigned_to_company lists every pending request, which only works with admin access. Each request shows the employee, type, dates and the approval step it is on.
Parameters
| Name | Type | Description |
|---|---|---|
| scope string | string | 'assigned_to_me' or 'assigned_to_company'. Default: assigned_to_me. |
Request
curl https://cotlet.dev/api/v1/bamboohr/pending-time-off-requests \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("bamboohr", "list_pending_time_off_requests")const result = await cotlet.call('bamboohr', 'list_pending_time_off_requests');cotlet call bamboohr list_pending_time_off_requestsExample response
{
"requests": [
{
"request_id": "to_5521",
"employee_id": "431",
"employee": "Lena Ortiz",
"type": "Vacation",
"start": "2026-11-02",
"end": "2026-11-03",
"days": 2,
"step": "Level 1 of 2"
},
{
"request_id": "to_5524",
"employee_id": "418",
"employee": "Tom Becker",
"type": "Sick",
"start": "2026-10-19",
"end": "2026-10-21",
"days": 3,
"step": "Level 1 of 1"
}
]
}