Get Events
List the Novacal events the authenticated user can access, including scheduling details, attendees, hosts, and current event status.
What this endpoint returns
This endpoint returns the events the authenticated user hosts or organizes. Use it to review scheduled meetings, sync event data into your own system, or build internal dashboards. Results are always paginated. Thedata object holds the events for the current page in data.data, alongside pagination metadata such as current_page, last_page, per_page, and total.
Filtering and pagination
next_page_url is null.
Common use cases
- Load a list of upcoming or past events
- Sync Novacal bookings into a CRM or reporting workflow
- Pull only the bookings for a given month with
startandend - Reconcile cancellations by requesting
status=canceled - Review attendee, host, and event status data before follow-up actions
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Filter events by status. Use active for events that have not been canceled, or canceled for canceled events.
active, canceled Only return events that end on or after this date. Accepts any parsable date or date-time value, for example 2026-07-01 or 2026-07-01 09:00:00.
"2026-07-01"
Only return events that end on or before this date. Must be after start. Accepts any parsable date or date-time value.
"2026-07-31"
The page of results to return. Defaults to 1.
x >= 11
The number of events per page, between 1 and 100. Defaults to 15.
1 <= x <= 10015
Sort direction for the event start time. Defaults to asc.
asc, desc