API ReferenceReference

Events endpoints

Exact request and response contracts for the events endpoints, generated from the enforced Partner API contract.

Endpoints in this group

GET/v1/eventsRead the event stream for reconciliation

Base path: /api/public/partner/v1. Every response carries request_id; every failure uses the standard error envelope documented under Errors.

GET`/v1/events`

Read the event stream for reconciliation

Authentication & scope

Authentication: Authorization: Bearer <API key>. The key is bound to one laboratory, one API client and one environment.
Required scope: events:read. A key without it is refused with 403 forbidden.

Query parameters

cursor (optional) — string
limit (optional) — integer

Responses

200 — Events after the cursor, oldest first.

json

{
  "data": [
    {
      "event_id": "8f14e45f-ceea-4c2b-9b3f-2a1d0c7b6a11",
      "type": "order.created",
      "version": 1,
      "occurred_at": "2026-01-15T14:32:07Z",
      "environment": "sandbox",
      "program_id": "5b2f0a19-7c64-4c8e-9a12-6de4f0b31c57",
      "data": {}
    }
  ],
  "request_id": "string",
  "cursor": "string"
}

Endpoints in this group

GET/v1/events

GET`/v1/events`