List calendars
Lists the calendars the user can see.
GET
/v1/calendars
Permission
The key must be granted calendar.events.read
A key without it gets 403 insufficient_scope, with the missing permission named in details.
Request
curl https://api.veruapis.com/v1/calendars \
-H "Authorization: Bearer vak_live_..."Response
| Field | Type | Description |
|---|---|---|
id |
string | Use this wherever an endpoint takes a calendar_id. |
name |
string | |
color |
string | A hex colour the calendar apps render it in. |
owner_email |
string | Who owns it. Not always you: a calendar shared with you appears here too. |
effective_permission |
string |
What this key may do with it once sharing is resolved.
ownerwriteread
|
{
"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 events in a calendar
- GET List events
- POST Respond to an invitation
- PATCH Update a calendar
- PATCH Update an event