Events
GET /events
curl -sS "https://nov3x.com/api/public/v1/events?limit=25" \
-H "Authorization: Bearer nvx_live_your_key_here"Scope: events.read
Query parameters
| Parameter | Type | Notes |
|---|---|---|
limit | integer | Page size, 1–100. Defaults to 25. Out-of-range values are clamped. |
cursor | string | From the previous response’s meta.cursor. |
updatedSince | ISO 8601 | Only events updated at or after this instant. A bad value returns 400. |
status | string | Filter by event status. |
Paging
Paging is cursor-based, which stays correct while records are being created underneath you — an offset would silently skip and repeat rows.
# first page
curl -sS "https://nov3x.com/api/public/v1/events?limit=100" -H "Authorization: Bearer $KEY"
# next page — pass meta.cursor back
curl -sS "https://nov3x.com/api/public/v1/events?limit=100&cursor=clx123" -H "Authorization: Bearer $KEY"Keep going while meta.hasMore is true.
Keeping a copy in sync
Store the highest updatedAt you have seen, then poll with updatedSince set
to it. You get only what changed.
GET /events/{id}
curl -sS https://nov3x.com/api/public/v1/events/clx1234567890 \
-H "Authorization: Bearer nvx_live_your_key_here"Returns 404 if the event is not in your workspace.
Fields
| Field | Type | Notes |
|---|---|---|
id | string | Stable identifier |
name | string | Event name |
type | string | e.g. EXHIBITION |
status | string | e.g. CONFIRMED |
startAt | ISO 8601 | Start |
endAt | ISO 8601 | End |
createdAt | ISO 8601 | Created |
updatedAt | ISO 8601 | Last modified — use for sync |