Skip to content
O ONCORR

Colour theme

Text size

Contrast

Request a quote

API documentation

Read events, registrations, check-ins, flight status and reports, and add registrations and invitations from your own systems — CRM, compliance, finance or a data warehouse. All requests and responses are JSON.

https://oncorr.info/api/v1
openapi.json (OpenAPI 3)
Organizer portal or admin panel → API & webhooks

Authentication & scopes

Send your personal access token in the Authorization header of every request. A token only sees the events its owner can see in ONCORR. Card numbers, passports, frequent-flyer numbers and internal notes are never returned.

curl https://oncorr.info/api/v1/events \
  -H "Authorization: Bearer onc_your_token_here" \
  -H "Accept: application/json"
Scopes
ScopeAllows
events:readRead events (names, dates, status, venue)
registrations:readRead registrations, check-in and flight status (no card or passport data)
registrations:writeCreate, update and cancel registrations
invitations:writeCreate and read invitations
reports:readRead summary reports (counts by status, check-in, invitations)
webhooks:manageSubscribe and unsubscribe webhooks (Zapier / Make instant triggers)

Paging, filters and rate limits

  • Lists return {"data": [...], "meta": {"page", "per_page", "total", "last_page"}, "links": {"next", "prev"}}. Use ?page=2&per_page=100 (max 100).
  • Filters are query parameters, listed with each endpoint below. Dates are YYYY-MM-DD or ISO 8601.
  • Each token has its own limit (120 requests a minute unless changed). Every response carries X-RateLimit-Limit and X-RateLimit-Remaining; over the limit you get 429 with Retry-After.

Errors

Errors use normal HTTP status codes and a JSON body:

{"error": {"code": "insufficient_scope", "message": "This token does not have the \"registrations:write\" scope."}}
Status codes
StatusMeaning
401Missing, wrong, revoked or expired token
403The token lacks the scope, or your IP address is not allowed
404Not found, or not one of your events
409Conflict — e.g. the person is already registered
422Invalid data — see "errors" for each field
429Too many requests — wait for Retry-After seconds

Account

GET /me events:read

Who am I

Shows the token name, owner, scopes and rate limit. Works with any scope.

Responses

200401403429

Events

GET /events events:read

List events

Parameters
ParameterInTypeDescription
status query string (requested | approved | activated | published | closed | archived | postponed) Filter by status.
q query string Search name, client or event code.
starts_after query string Start date on or after (YYYY-MM-DD).
starts_before query string Start date on or before (YYYY-MM-DD).
sort query string (id | start_date) Sort field.
direction query string (asc | desc) Sort direction.
page query integer Page number.
per_page query integer Items per page (max 100).

Responses

200401403429

GET /events/{event} events:read

Get an event

Parameters
ParameterInTypeDescription
event* path integer Event ID.

Responses

200404401403429

Registrations

GET /events/{event}/registrations registrations:read

List registrations

Parameters
ParameterInTypeDescription
event* path integer Event ID.
status query string (registered | incomplete | cancelled | deleted) Filter by status.
email query string Exact e-mail address.
registered_since query string Registered on or after this date/time.
checked_in query boolean Only guests who have (true) or have not (false) checked in.
direction query string (asc | desc) Order by ID.
page query integer Page number.
per_page query integer Items per page (max 100).

Responses

200404401403429

POST /events/{event}/registrations registrations:write

Create a registration

Finds the person by e-mail (or creates their profile) and registers them. Fires the `registration.created` webhook when the status is `registered`.

Parameters
ParameterInTypeDescription
event* path integer Event ID.

JSON body

Body fields
FieldType
first_name* string
last_name* string
email* string
title string
company string
phone string
mobile string
city string
state string
country string
attendee_type string
status string (registered | incomplete)

Responses

201409422401403429

GET /registrations/{registration} registrations:read

Get a registration

Parameters
ParameterInTypeDescription
registration* path integer Registration ID.

Responses

200404401403429

PATCH /registrations/{registration} registrations:write

Update or cancel a registration

Send only the fields you want to change. `status: cancelled` cancels the registration.

Parameters
ParameterInTypeDescription
registration* path integer Registration ID.

JSON body

Body fields
FieldType
first_name string
last_name string
email string
title string
company string
phone string
mobile string
attendee_type string
status string (registered | cancelled)

Responses

200404422401403429

GET /events/{event}/checkins registrations:read

List check-ins

Parameters
ParameterInTypeDescription
event* path integer Event ID.
since query string Checked in on or after.
page query integer Page number.
per_page query integer Items per page (max 100).

Responses

200401403429

GET /events/{event}/flights registrations:read

Flight status of guests

Live (or simulated) status of the guests' tracked flights.

Parameters
ParameterInTypeDescription
event* path integer Event ID.
page query integer Page number.
per_page query integer Items per page (max 100).

Responses

200401403429

Invitations

GET /events/{event}/invitations invitations:write

List invitations

Parameters
ParameterInTypeDescription
event* path integer Event ID.
status query string (new | sent | registered | declined) Filter by status.
email query string Exact e-mail address.
page query integer Page number.
per_page query integer Items per page (max 100).

Responses

200401403429

POST /events/{event}/invitations invitations:write

Invite a person

Adds the person to the invitation list with a personal invitation code. The invitation e-mail is sent from ONCORR's invitation screens.

Parameters
ParameterInTypeDescription
event* path integer Event ID.

JSON body

Body fields
FieldType
first_name* string
last_name* string
email* string
company string
status string (new | sent)

Responses

201200401403429

Reports

GET /events/{event}/reports/summary reports:read

Event summary

Parameters
ParameterInTypeDescription
event* path integer Event ID.

Responses

200401403429

Webhooks

GET /webhooks webhooks:manage

List webhook subscriptions

Parameters
ParameterInTypeDescription
page query integer Page number.
per_page query integer Items per page (max 100).

Responses

200401403429

POST /webhooks webhooks:manage

Subscribe a webhook

Delivers the chosen events to `url` as signed JSON (see X-Oncorr-Signature). The receiving host must be allowed by an ONCORR administrator. Sandbox keys must send the `event_id` of a [DEMO] event.

JSON body

Body fields
FieldType
url* string
events* array
event_id integer
name string

Responses

201422401403429

DELETE /webhooks/{webhook} webhooks:manage

Unsubscribe a webhook

Parameters
ParameterInTypeDescription
webhook* path integer

Responses

204404401403429

Webhooks

Instead of asking the API every few minutes, add a webhook endpoint under API & webhooks. ONCORR POSTs a JSON message to your URL when something happens. Answer with any 2xx status within 10 seconds; otherwise we retry after 1, 5 and 30 minutes, 2, 6, 12 and 24 hours. After 50 failures in a row the endpoint is switched off and you can switch it on again.

Webhook events
EventWhen
registration.createdA registration was created
registration.updatedA registration was changed
registration.cancelledA registration was cancelled
checkin.createdA guest checked in
flight.changedA tracked flight changed (delay, gate, landing…)
payment.succeededA payment was received
invitation.respondedAn invitee registered or declined

Example message

{
    "id": "evt_01jbz9x3y8k2m4q6r7s8t9v0w1",
    "type": "registration.created",
    "created_at": "2026-10-04T14:05:09+00:00",
    "data": {
        "id": 98123,
        "object": "registration",
        "event_id": 1234,
        "status": "registered",
        "first_name": "Ann",
        "last_name": "Lee",
        "email": "ann.lee@example.com",
        "attendee_type": "Investigator",
        "check_in": {
            "checked_in": false,
            "checked_in_at": null,
            "method": null
        }
    }
}

Check the signature

Headers: X-Oncorr-Event, X-Oncorr-Delivery and X-Oncorr-Signature: t=1791200000,v1=5f1c…. Compute HMAC-SHA256 of t + "." + raw request body with your endpoint's signing secret and compare it with v1 using a constant-time comparison. Reject messages whose t is more than 5 minutes old. The same message may arrive twice — use id to ignore duplicates.

// Node.js
const [t, v1] = header.split(',').map(p => p.split('=')[1]);
const expected = crypto.createHmac('sha256', secret).update(`${t}.${rawBody}`).digest('hex');
const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1));

AI tools (MCP server)

ONCORR is a Model Context Protocol server, so AI apps such as Claude, ChatGPT (Responses API) or Microsoft Copilot can use your event data. It uses the same access tokens, permissions, event visibility, rate limit and redactions as this API. Tools that change data first answer with a preview and only act when called again with "confirm": true. Every call is written to the API log and the audit journal.

POST https://oncorr.info/mcp
Streamable HTTP, JSON answers, stateless (no session id)
2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05

OAuth 2.1 (for Claude.ai / ChatGPT custom connectors): a request without a token gets 401 with WWW-Authenticate: Bearer resource_metadata="https://oncorr.info/.well-known/oauth-protected-resource/mcp". Discovery: https://oncorr.info/.well-known/oauth-authorization-server (RFC 8414); dynamic client registration POST https://oncorr.info/oauth/register (RFC 7591, https redirect URIs, http only for localhost, exact match); authorization code with PKCE S256 only at https://oncorr.info/oauth/authorize (a staff member or organizer signs in and approves scopes); POST https://oncorr.info/oauth/token returns 1-hour access tokens and rotating refresh tokens; POST https://oncorr.info/oauth/revoke (RFC 7009). OAuth access tokens carry the approved API scopes and work at /mcp only.

Methods: initialize, ping, tools/list, tools/call, resources/list, resources/templates/list, resources/read, prompts/list, prompts/get. Resources: oncorr://guide, oncorr://events/{id}, oncorr://events/{id}/summary.

curl https://oncorr.info/mcp \
  -H "Authorization: Bearer onc_your_token_here" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_events","arguments":{"query":"Investigator"}}}'
MCP tools
ToolScopeWhat it does
whoamianyThe ONCORR account behind this connection: name, permissions (scopes) and how many events it can see.
list_eventsevents:readEvents this account can see, newest first. Filter by name / client / event code, status or start date.
get_eventevents:readName, dates, status, client, venue and registration deadline of one event.
event_summaryreports:readCounts of registrations by status and attendee type, invitations by status and the check-in rate.
search_registrationsregistrations:readRegistrations of an event. Search by name, e-mail, company or registration code, or filter by status / check-in.
get_registrationregistrations:readOne registration: contact details, status, hotel dates, flights and check-in.
checkin_statsregistrations:readLive check-in numbers of an event (or one agenda session): arrived, expected, by attendee type, latest arrivals.
flight_status_boardregistrations:readTracked arrival and departure flights of the guests with live (or simulated) status, delays and gates.
list_invitationsinvitations:writeInvitation list of an event with each person's status (new, sent, registered, declined).
create_registration ✱registrations:writeRegisters a person for an event (finds or creates their profile by e-mail). Without confirm: true it only shows a preview.
update_registration ✱registrations:writeChanges names, contact details or attendee type of a registration. Send only the fields to change. Without confirm: true it only shows a preview.
cancel_registration ✱registrations:writeCancels a registration (the person is marked as not attending). Without confirm: true it only shows a preview.
check_in_guest ✱registrations:writeChecks a registered guest in at the event (or an agenda session). Without confirm: true it only shows a preview.
invite_person ✱invitations:writeAdds a person to an event's invitation list with a personal invitation code (the e-mail is sent from ONCORR's invitation screens). Without confirm: true it only shows a preview.

✱ Changes data: needs the write scope and "confirm": true; without it the answer is a preview (structuredContent.preview = true) and nothing changes.

Zapier / Make actions

Automation tools trigger on ONCORR's webhooks and act on ONCORR through a signed action endpoint. Create an action key under Zapier & Make (admin panel or organizer portal). Organizer keys only reach the organizer's events; a key can be limited to one event and to some actions.

POST https://oncorr.info/api/integrations/actions/registration.create      (or /invitation.create)
Content-Type: application/json
X-Oncorr-Key: oak_…
X-Oncorr-Signature: t={unix time},v1={hex HMAC-SHA256 of "t.rawBody" with the key's signing secret}
Idempotency-Key: {optional; repeats within 24 h return the first answer}

{"event_id": 1234, "first_name": "Ann", "last_name": "Lee", "email": "ann.lee@example.com",
 "company": "Acme", "title": "", "phone": "", "mobile": "", "city": "", "state": "", "country": "", "attendee_type": "Investigator"}
Action answers
StatusMeaning
201Created — body {"data": {registration or invitation}, "created": true}
200Already registered / invited (nothing created), or an idempotent replay
401Unknown or switched-off key, bad or stale signature (more than 5 minutes)
403The key may not run this action
404Unknown action, or an event the key may not use
422Invalid data — see "errors"
429More than 60 actions a minute for this key