cURL
curl --request GET \
--url https://api.novacal.io/v1/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.novacal.io/v1/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.novacal.io/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.novacal.io/v1/events",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.novacal.io/v1/events"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.novacal.io/v1/events")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.novacal.io/v1/events")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"current_page": 1,
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type_id": 42,
"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"
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"first_page_url": "<string>",
"from": 1,
"last_page": 3,
"last_page_url": "<string>",
"links": [
{
"url": "<string>",
"label": "<string>",
"active": true
}
],
"next_page_url": "<string>",
"path": "<string>",
"per_page": 15,
"prev_page_url": "<string>",
"to": 15,
"total": 42
}
}Events
Get Events
List the Novacal events the authenticated user can access, including scheduling details, attendees, hosts, and current event status.
GET
/
v1
/
events
cURL
curl --request GET \
--url https://api.novacal.io/v1/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.novacal.io/v1/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.novacal.io/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.novacal.io/v1/events",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.novacal.io/v1/events"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.novacal.io/v1/events")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.novacal.io/v1/events")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"current_page": 1,
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type_id": 42,
"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"
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"first_page_url": "<string>",
"from": 1,
"last_page": 3,
"last_page_url": "<string>",
"links": [
{
"url": "<string>",
"label": "<string>",
"active": true
}
],
"next_page_url": "<string>",
"path": "<string>",
"per_page": 15,
"prev_page_url": "<string>",
"to": 15,
"total": 42
}
}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
| Parameter | Description |
|---|---|
status | active returns events that have not been canceled, canceled returns canceled events |
start | Only return events ending on or after this date, for example 2026-07-01 |
end | Only return events ending on or before this date. Must be after start |
page | The page of results to return. Defaults to 1 |
per_page | Events per page, between 1 and 100. Defaults to 15 |
order_direction | Sort direction for the event start time, asc or desc. Defaults to asc |
curl --request GET \
--url "https://api.novacal.io/v1/events?status=active&start=2026-07-01&end=2026-07-31&per_page=50" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Accept: application/json"
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