APIOverview

Novex API

The Novex API lets your own systems read data out of Novex — events, registrations (including check-in state), and invoices. It is a normal REST API over HTTPS returning JSON.

⚠️ Preview. This is version 2026-08-04-preview. It is usable and credentialed, and we will not remove or rename anything silently — but the shape may still change before we mark it stable. See Versioning for exactly what can and cannot change.

Before you start

  • Plan requirement. API access is available on Spectrum and above. On Beam or Flare, every request returns 402.
  • Create a key. Settings → API, as a tenant admin. The key is shown once.
  • Base URL. https://nov3x.com/api/public/v1

Your first request

curl -sS https://nov3x.com/api/public/v1/events \
  -H "Authorization: Bearer nvx_live_your_key_here"
{
  "data": [
    {
      "id": "clx1234567890",
      "name": "Riyadh Tech Summit",
      "type": "EXHIBITION",
      "status": "CONFIRMED",
      "startAt": "2026-09-01T08:00:00.000Z",
      "endAt": "2026-09-02T17:00:00.000Z",
      "createdAt": "2026-05-01T09:12:44.000Z",
      "updatedAt": "2026-08-01T11:03:02.000Z"
    }
  ],
  "meta": { "total": 1, "cursor": null, "hasMore": false }
}

What is in this release

This release is read-only. Three resources:

Writing registrations, checking attendees in over the API, and outbound webhooks are planned for the next releases.

Machine-readable spec

An OpenAPI 3.1 document is served at /api/public/v1/openapi.json. It needs no key — you can read it before you have one. It is generated from the same definitions the API responds with, so it does not drift from the live behaviour.

In this section

  • Authentication — creating, using, rotating and revoking keys.
  • Rate limits — the ceilings and the headers.
  • Versioning — what counts as a breaking change.
  • Errors — every error code and what causes it.
Social accountsAuthentication