List deliveries for a webhook

List events that have been dispatched to a webhook, one row per event with its current delivery status. Use the after query param to page through results.

GET /webhooks/{webhookId}/events

List deliveries for a webhook

cURL

curl --request GET \
  --url https://dev-public-api.openphone.dev/webhooks/{webhookId}/events \
  --header 'Authorization: <api-key>' \
  --header 'Quo-Api-Version: <quo-api-version>'

200

{
  "data": [
    {
      "id": "msg_2abcDEFghiJKLmnoPQRstu",
      "eventType": "message.received",
      "status": "success",
      "nextAttemptAt": "2026-01-01T00:05:00Z",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextCursor": "eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
}

{
  "message": "/webhookId: Expected string to match '^[0-9]+$'",
  "docs": "https://quo.com/docs",
  "title": "Bad Request",
  "errors": [
    {
      "path": "/webhookId",
      "message": "Expected string to match '^[0-9]+$'",
      "value": "abc123",
      "schema": {
        "type": "String",
        "pattern": "^[0-9]+$"
      }
    }
  ]
}

{
  "message": "You are unauthorized to access the webhook",
  "docs": "https://quo.com/docs",
  "title": "Unauthorized"
}

{
  "message": "You are forbidden to access the webhook",
  "docs": "https://quo.com/docs",
  "title": "Forbidden"
}

{
  "message": "Webhook with ID 123 not found",
  "docs": "https://quo.com/docs",
  "title": "Not Found"
}

{
  "message": "An unknown error occurred",
  "docs": "https://quo.com/docs",
  "title": "Unknown Error"
}

Authorizations

Authorization · string · header · required

Headers

Quo-Api-Version · enum<string> · required

API version header. Supported values: 2026-03-30

Available options: 2026-03-30

Path Parameters

webhookId · string · required

The unique identifier of a webhook

Pattern: ^[0-9]+$

Example:

"123"

Query Parameters

limit · integer · default: 10

Max number of items to return per page.

Required range: 1 <= x <= 50

after · string

Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"

status · enum<string>

Current delivery status of the event: success once any attempt succeeded, pending before the first attempt, sending mid-retry, or failed after all retries are exhausted.

Available options: success, pending, sending, failed

Example:

"success"

eventTypes · enum<string>[]

Restrict results to deliveries of these event types.

Minimum array length: 1

Event type

Available options: call.answered, call.completed, call.forwarded, call.menu.selected, call.missed, call.ringing, call.recording.completed, call.summary.completed, call.transcript.completed, call.voicemail.completed, message.received, message.delivered, message.failed, message.undelivered, contact.updated, contact.deleted, task.assigned, task.created, task.completed, task.updated, task.deleted, task.unassigned, task.reopened, task.duedate.removed, task.duedate.updated, task.overdue, task.linked, task.unlinked, integration.created, integration.updated, integration.deleted

Example:

["message.received"]

createdBefore · string<date-time>

Only include deliveries dispatched before this ISO 8601 timestamp.

Example:

"2026-01-02T00:00:00Z"

createdAfter · string<date-time>

Only include deliveries dispatched after this ISO 8601 timestamp.

Example:

"2026-01-01T00:00:00Z"

Response

200

application/json

OK

data · object[] · required

Show child attributes

nextCursor · string | null · required

Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"