Events

Endpoints for listing events.

get
List Events

https://api.savvycal.com/v1/events
This endpoint allows you to list your scheduled events.
Request
Response
Request
Headers
Authorization
required
string
Bearer <your-access-token>
Query Parameters
state
optional
string
Filter the query by event state (either `confirmed`, `canceled`, or `all`). Defaults to `confirmed`.
period
optional
string
Filter the query by when events occur (either `past`, `upcoming`, or `all`). Defaults to `upcoming`.
before
optional
string
A pagination cursor for entries before a specific point in the collection.
after
optional
string
A pagination cursor for entries after a specific point in the collection.
limit
optional
integer
The maximum number of entries to retrieve (defaults to 20, up to 100 allowed).
Response
200: OK
Returns a paginated list of event resources.
{
"entries": [
// items
],
"metadata": {
"before": nil,
"after": "g3QAAAABZAACaWRiAAAbFA==",
"limit": 20
}
}

When successful, returns a Paginated List of Event resources with a 200 status code.

get
Get Event

https://api.savvycal.com/v1/events/:event_id
This endpoint allows you to fetch a single event.
Request
Response
Request
Headers
Authorization
required
string
Bearer <your-access-token>
Response
200: OK
Returns an event.
{
"id": "event_01ED74HMFGVZ92YVCWTD8Y8H6X",
// ...
}

When successful, returns an Event resource with a 200 status code.