List colleague absences
Read who is out in a period, as Show colleagues displays it.
GET https://cotlet.dev/api/v1/officient/colleague-absences
read
Returns the colleagues' calendar entries between the two dates: person, type, dates and day part. Home office entries come back too, with their own type. Sorted by first day.
Parameters
| Name | Type | Description |
|---|---|---|
| from_date string required | string | First day, ISO date (2026-11-09). |
| to_date string required | string | Last day, ISO date (2026-11-13). |
| team string | string | Only people of this team. |
Request
curl "https://cotlet.dev/api/v1/officient/colleague-absences?from_date=2026-11-09&to_date=2026-11-13" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("officient", "list_colleague_absences", {"from_date":"2026-11-09","to_date":"2026-11-13"})const result = await cotlet.call('officient', 'list_colleague_absences', {"from_date":"2026-11-09","to_date":"2026-11-13"});cotlet call officient list_colleague_absences --data '{"from_date":"2026-11-09","to_date":"2026-11-13"}'Example response
{
"absences": [
{
"person": "Lena Maes",
"type": "Holiday",
"from_date": "2026-11-09",
"to_date": "2026-11-13",
"day_part": "full_day"
},
{
"person": "Tom De Smet",
"type": "Holiday",
"from_date": "2026-11-11",
"to_date": "2026-11-11",
"day_part": "half_day"
},
{
"person": "Aya Claes",
"type": "Home office",
"from_date": "2026-11-11",
"to_date": "2026-11-11",
"day_part": "full_day"
}
],
"total": 3
}