Api

List Webhook Deliveries

GET
/v1/webhook-deliveries

List webhook deliveries newest first, 50 per page; filter by endpointId or state. Needs the webhooks: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]*)$
endpointId?string
Match\S
Length1 <= length <= 512
state?string

Value in

  • "pending"
  • "succeeded"
  • "failed"
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/webhook-deliveries?projectId=string"
{  "success": true,  "data": [    {      "id": "string",      "createdAt": "string",      "updatedAt": "string",      "projectId": "string",      "endpointId": "string",      "eventId": "string",      "eventType": "participant.created",      "subjectId": "string",      "state": "pending",      "attemptCount": 0,      "nextAttemptAt": "string",      "lastAttemptAt": "string",      "lastStatusCode": -9007199254740991,      "lastError": "string"    }  ]}