ArcalotlArcalotl
Events

List projected public events

Polling and reconciliation feed. Ordered newest-first with keyset pagination. Filter by one or more event types, or resume after a known event id. Requires the events:read scope.

Serverhttps://api.arcalotl.com
GET
/v1/events

Authorization

apiKey
AuthorizationBearer <token>

Community-scoped API key. Send it as Authorization: Bearer arclt_live_.... Keys carry scopes; endpoints that need a specific scope answer 403 missing_scope when the key lacks it.

In: header

Query Parameters

type?array<string>

One or more public event types. Repeat the parameter or provide a comma-separated list.

after_id?string

Return only events created after the given event id.

cursor?string

Opaque keyset cursor copied verbatim from a previous response's next_cursor. Omit it to fetch the first page.

limit?integer

Page size, capped at 100.

Default25
Range1 <= value <= 100

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/events?cursor=eyJpZCI6IjAxSk1aWDQ3In0&limit=25"
{
  "data": [
    {
      "id": "evt_01JMZXA1B2",
      "type": "subscription.active",
      "timestamp": "2026-07-01T12:00:00Z",
      "api_version": "2026-08",
      "data": {}
    }
  ],
  "next_cursor": "eyJpZCI6ImV2dF8wMUpNWlhBMSJ9"
}
{
  "type": "https://docs.arcalotl.com/api/errors#invalid_request",
  "title": "Bad Request",
  "status": 400,
  "detail": "The 'cursor' parameter is not a valid cursor from a previous response.",
  "code": "invalid_request"
}
{
  "type": "https://docs.arcalotl.com/api/errors#unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid API key is required. Provide it as 'Authorization: Bearer arclt_live_...'.",
  "code": "unauthorized"
}
{
  "type": "https://docs.arcalotl.com/api/errors#missing_scope",
  "title": "Forbidden",
  "status": 403,
  "detail": "This API key is missing the required scope: subscriptions:read.",
  "code": "missing_scope"
}
{
  "type": "https://docs.arcalotl.com/api/errors#rate_limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded. Retry after the interval in the Retry-After header.",
  "code": "rate_limited"
}

POSTCreate a checkout link

Creates a checkout for either a first-party platform identity or an operator-controlled subject. External checkouts return the provider's hosted URL, require no connected community platform, and return the canonical Arcalotl `member_id` for the operator's identity map. Closing checkout changes no entitlement state; create a new checkout link if the buyer returns. Supply an `Idempotency-Key` header to make retries safe.

GETGet one public event

Returns a single public event envelope by id.