List events
Events of one calendar between two dates, oldest first.
GET https://cotlet.dev/api/v1/nextcloud/events
read
Returns the events of one calendar that fall in the time range, oldest first, with title, start, end, location and all-day flag. Use it before creating an event to find overlaps.
Parameters
| Name | Type | Description |
|---|---|---|
| calendar string required | string | Calendar from list_calendars. |
| from datetime required | datetime | Start of the range. |
| to datetime required | datetime | End of the range. |
Request
curl "https://cotlet.dev/api/v1/nextcloud/events?calendar=calendar&from=2026-10-01T09%3A00%3A00Z&to=2026-10-01T09%3A00%3A00Z" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("nextcloud", "list_events", {"calendar":"calendar","from":"2026-10-01T09:00:00Z","to":"2026-10-01T09:00:00Z"})const result = await cotlet.call('nextcloud', 'list_events', {"calendar":"calendar","from":"2026-10-01T09:00:00Z","to":"2026-10-01T09:00:00Z"});cotlet call nextcloud list_events --data '{"calendar":"calendar","from":"2026-10-01T09:00:00Z","to":"2026-10-01T09:00:00Z"}'Example response
{
"events": [
{
"event_id": "a41c0d7e-5b2f-4c1a-9e20-77d3f0b6c812",
"title": "Acme kickoff",
"start": "2026-10-21T10:00:00+02:00",
"end": "2026-10-21T11:00:00+02:00",
"location": "Video call",
"all_day": false
}
]
}