ONCORR API · version 1.0.0
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.
- Base URL
- https://oncorr.info/api/v1
- Machine-readable spec
- openapi.json (OpenAPI 3)
- Get a token
- 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"
| Scope | Allows |
|---|---|
| events:read | Read events (names, dates, status, venue) |
| registrations:read | Read registrations, check-in and flight status (no card or passport data) |
| registrations:write | Create, update and cancel registrations |
| invitations:write | Create and read invitations |
| reports:read | Read summary reports (counts by status, check-in, invitations) |
| webhooks:manage | Subscribe 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-DDor ISO 8601. - Each token has its own limit (120 requests a minute unless changed). Every response carries
X-RateLimit-LimitandX-RateLimit-Remaining; over the limit you get429withRetry-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 | Meaning |
|---|---|
| 401 | Missing, wrong, revoked or expired token |
| 403 | The token lacks the scope, or your IP address is not allowed |
| 404 | Not found, or not one of your events |
| 409 | Conflict — e.g. the person is already registered |
| 422 | Invalid data — see "errors" for each field |
| 429 | Too many requests — wait for Retry-After seconds |
Account
/me
events:read
Who am I
Shows the token name, owner, scopes and rate limit. Works with any scope.
Responses
200401403429
Events
/events
events:read
List events
| Parameter | In | Type | Description |
|---|---|---|---|
| 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
/events/{event}
events:read
Get an event
| Parameter | In | Type | Description |
|---|---|---|---|
| event* | path | integer | Event ID. |
Responses
200404401403429
Registrations
/events/{event}/registrations
registrations:read
List registrations
| Parameter | In | Type | Description |
|---|---|---|---|
| event* | path | integer | Event ID. |
| status | query | string (registered | incomplete | cancelled | deleted) | Filter by status. |
| 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
/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`.
| Parameter | In | Type | Description |
|---|---|---|---|
| event* | path | integer | Event ID. |
JSON body
| Field | Type |
|---|---|
| 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
/registrations/{registration}
registrations:read
Get a registration
| Parameter | In | Type | Description |
|---|---|---|---|
| registration* | path | integer | Registration ID. |
Responses
200404401403429
/registrations/{registration}
registrations:write
Update or cancel a registration
Send only the fields you want to change. `status: cancelled` cancels the registration.
| Parameter | In | Type | Description |
|---|---|---|---|
| registration* | path | integer | Registration ID. |
JSON body
| Field | Type |
|---|---|
| first_name | string |
| last_name | string |
| string | |
| title | string |
| company | string |
| phone | string |
| mobile | string |
| attendee_type | string |
| status | string (registered | cancelled) |
Responses
200404422401403429
/events/{event}/checkins
registrations:read
List check-ins
| Parameter | In | Type | Description |
|---|---|---|---|
| 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
/events/{event}/flights
registrations:read
Flight status of guests
Live (or simulated) status of the guests' tracked flights.
| Parameter | In | Type | Description |
|---|---|---|---|
| event* | path | integer | Event ID. |
| page | query | integer | Page number. |
| per_page | query | integer | Items per page (max 100). |
Responses
200401403429
Invitations
/events/{event}/invitations
invitations:write
List invitations
| Parameter | In | Type | Description |
|---|---|---|---|
| event* | path | integer | Event ID. |
| status | query | string (new | sent | registered | declined) | Filter by status. |
| query | string | Exact e-mail address. | |
| page | query | integer | Page number. |
| per_page | query | integer | Items per page (max 100). |
Responses
200401403429
/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.
| Parameter | In | Type | Description |
|---|---|---|---|
| event* | path | integer | Event ID. |
JSON body
| Field | Type |
|---|---|
| first_name* | string |
| last_name* | string |
| email* | string |
| company | string |
| status | string (new | sent) |
Responses
201200401403429
Reports
/events/{event}/reports/summary
reports:read
Event summary
| Parameter | In | Type | Description |
|---|---|---|---|
| event* | path | integer | Event ID. |
Responses
200401403429
Webhooks
/webhooks
webhooks:manage
List webhook subscriptions
| Parameter | In | Type | Description |
|---|---|---|---|
| page | query | integer | Page number. |
| per_page | query | integer | Items per page (max 100). |
Responses
200401403429
/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
| Field | Type |
|---|---|
| url* | string |
| events* | array |
| event_id | integer |
| name | string |
Responses
201422401403429
/webhooks/{webhook}
webhooks:manage
Unsubscribe a webhook
| Parameter | In | Type | Description |
|---|---|---|---|
| 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.
| Event | When |
|---|---|
| registration.created | A registration was created |
| registration.updated | A registration was changed |
| registration.cancelled | A registration was cancelled |
| checkin.created | A guest checked in |
| flight.changed | A tracked flight changed (delay, gate, landing…) |
| payment.succeeded | A payment was received |
| invitation.responded | An 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.
- Endpoint
- POST https://oncorr.info/mcp
- Transport
- Streamable HTTP, JSON answers, stateless (no session id)
- Protocol versions
- 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"}}}'
| Tool | Scope | What it does |
|---|---|---|
| whoami | any | The ONCORR account behind this connection: name, permissions (scopes) and how many events it can see. |
| list_events | events:read | Events this account can see, newest first. Filter by name / client / event code, status or start date. |
| get_event | events:read | Name, dates, status, client, venue and registration deadline of one event. |
| event_summary | reports:read | Counts of registrations by status and attendee type, invitations by status and the check-in rate. |
| search_registrations | registrations:read | Registrations of an event. Search by name, e-mail, company or registration code, or filter by status / check-in. |
| get_registration | registrations:read | One registration: contact details, status, hotel dates, flights and check-in. |
| checkin_stats | registrations:read | Live check-in numbers of an event (or one agenda session): arrived, expected, by attendee type, latest arrivals. |
| flight_status_board | registrations:read | Tracked arrival and departure flights of the guests with live (or simulated) status, delays and gates. |
| list_invitations | invitations:write | Invitation list of an event with each person's status (new, sent, registered, declined). |
| create_registration ✱ | registrations:write | Registers a person for an event (finds or creates their profile by e-mail). Without confirm: true it only shows a preview. |
| update_registration ✱ | registrations:write | Changes 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:write | Cancels a registration (the person is marked as not attending). Without confirm: true it only shows a preview. |
| check_in_guest ✱ | registrations:write | Checks a registered guest in at the event (or an agenda session). Without confirm: true it only shows a preview. |
| invite_person ✱ | invitations:write | Adds 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"}
| Status | Meaning |
|---|---|
| 201 | Created — body {"data": {registration or invitation}, "created": true} |
| 200 | Already registered / invited (nothing created), or an idempotent replay |
| 401 | Unknown or switched-off key, bad or stale signature (more than 5 minutes) |
| 403 | The key may not run this action |
| 404 | Unknown action, or an event the key may not use |
| 422 | Invalid data — see "errors" |
| 429 | More than 60 actions a minute for this key |