Skip to main content
GET
cURL

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. The data 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

Paginate by requesting the next page until 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 start and end
  • Reconcile cancellations by requesting status=canceled
  • Review attendee, host, and event status data before follow-up actions

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

status
enum<string>

Filter events by status. Use active for events that have not been canceled, or canceled for canceled events.

Available options:
active,
canceled
start
string

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.

Example:

"2026-07-01"

end
string

Only return events that end on or before this date. Must be after start. Accepts any parsable date or date-time value.

Example:

"2026-07-31"

page
integer

The page of results to return. Defaults to 1.

Required range: x >= 1
Example:

1

per_page
integer

The number of events per page, between 1 and 100. Defaults to 15.

Required range: 1 <= x <= 100
Example:

15

order_direction
enum<string>

Sort direction for the event start time. Defaults to asc.

Available options:
asc,
desc

Response

200 - application/json

Paginated events response

success
boolean
required

Indicates whether the request was successful

Example:

true

data
object
required

A page of events together with its pagination metadata