Skip to main content
GET
/
v1
/
events
cURL
curl --request GET \
  --url https://api.novacal.io/v1/events \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "start": "2023-11-07T05:31:56Z",
      "end": "2023-11-07T05:31:56Z",
      "canceled_at": "2023-11-07T05:31:56Z",
      "cancellation_reason": "<string>",
      "location": "<string>",
      "form_field_answers": {
        "name": "John Doe",
        "email": "john@example.com"
      },
      "status": "<string>",
      "name": "<string>",
      "organizer": {
        "first_name": "<string>",
        "last_name": "<string>",
        "name": "<string>",
        "email": "jsmith@example.com",
        "username": "<string>",
        "timezone": "<string>",
        "time_format": 12,
        "start_of_week": 0,
        "avatar": "<string>"
      },
      "hosts": [
        {
          "first_name": "<string>",
          "last_name": "<string>",
          "name": "<string>",
          "email": "jsmith@example.com",
          "username": "<string>",
          "timezone": "<string>",
          "time_format": 12,
          "start_of_week": 0,
          "avatar": "<string>"
        }
      ],
      "booker": {
        "name": "<string>",
        "email": "jsmith@example.com",
        "timezone": "<string>",
        "time_format": 12
      },
      "guests": [
        "jsmith@example.com"
      ]
    }
  ]
}

​
What this endpoint returns

This endpoint returns the events visible to the authenticated user. Use it to review scheduled meetings, sync event data into your own system, or build internal dashboards.

​
Common use cases

  • Load a list of upcoming or past events
  • Sync Novacal bookings into a CRM or reporting workflow
  • 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.

Response

200 - application/json

Events response

​
success
boolean
required

Indicates whether the request was successful

Example:

true

​
data
object[]
required