List events in a calendar
Lists events in one calendar over a time range.
GET
/v1/calendars/:calendar_id/events
Permission
The key must be granted calendar.events.read
A key without it gets 403 insufficient_scope, with the missing permission named in details.
Path parameters
| Field | Type | Description |
|---|---|---|
calendar_id required |
string |
Query parameters
| Field | Type | Description |
|---|---|---|
start required |
RFC 3339 | |
end required |
RFC 3339 | |
limit |
integer |
Defaults to 250
|
Request
curl https://api.veruapis.com/v1/calendars/:calendar_id/events \
-H "Authorization: Bearer vak_live_..."Response
{
"data": { ... },
"meta": { "request_id": "req_01j8z9...", "timestamp": "2026-09-02T10:00:00Z" }
}A worked example for this endpoint has not been written yet.
Errors
Every failure uses the same shape, with a stable string code you can branch on. See the error reference.
Related
- POST Create a calendar
- POST Create an event
- DELETE Delete a calendar
- DELETE Delete an event
- POST Find a time that works
- POST Query free/busy
- GET Get a calendar
- GET Get an event
- GET List calendars
- GET List events
- POST Respond to an invitation
- PATCH Update a calendar
- PATCH Update an event