SolutionsPricingDocsStart Free
Api

List Events

GET
/v1/events

List the Events of a Project, newest first, 50 per page, with their processing state. Use diagnose_event for one Event. Needs the referrals:read key permission.

Authorization

WorkspaceApiKey
X-Api-Key<token>

Workspace-owned Better Auth API key of one environment (Sandbox or Live); it authorizes the Projects of that environment in its Workspace. A Project of the other environment returns 403 ENVIRONMENT_MISMATCH. Never expose it in the browser.

In: header

Query Parameters

offset?string
Match^(0|[1-9][0-9]*)$
projectId*string
Length1 <= length <= 128

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/events?projectId=string"
{  "success": true,  "data": [    {      "id": "string",      "createdAt": "string",      "updatedAt": "string",      "projectId": "string",      "participantId": "string",      "type": "string",      "actorParticipantId": "string",      "sourceNamespaceId": "string",      "sourceEventId": "string",      "occurredAt": "string",      "receivedAt": "string",      "normalizedFacts": {        "property1": null,        "property2": null      },      "factsHash": "string",      "processingState": "pending",      "processingReason": "awaiting_attribution",      "attemptCount": 0,      "nextAttemptAt": "string"    }  ]}