List time off

Time off entries and their types.

GET https://cotlet.dev/api/v1/resource-guru/time-offs

read

Returns each time off entry with its ID, people, dates and type: Vacation/Holiday (personal), Public holiday, Sick leave, Maternity/paternity leave or Compassionate leave. Run it before add_time_off to avoid duplicates.

Parameters

Parameters: list_time_off
NameTypeDescription
start_date string string Only entries starting on or after this date, YYYY-MM-DD.
end_date string string Only entries ending on or before this date, YYYY-MM-DD.
resource_ids integer[] integer[] Only entries for these resources.

Request

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

Example response

JSON

{
  "time_off": [
    {
      "id": 902115,
      "resource_ids": [
        18211
      ],
      "from": "2026-12-24",
      "to": "2026-12-26",
      "type": "Public holiday",
      "details": "Christmas"
    }
  ]
}

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.