Skip to main content
GET
/
webhooks
/
{webhookId}
/
events
List deliveries for a webhook
curl --request GET \
  --url https://api.quo.com/webhooks/{webhookId}/events \
  --header 'Authorization: <api-key>' \
  --header 'Quo-Api-Version: <quo-api-version>'
{
  "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
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

OK

data
object[]
required
nextCursor
string | null
required
Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"