> ## Documentation Index > Fetch the complete documentation index at: https://www.quo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-2026-03-30-prod.json get /webhooks/{webhookId}/events openapi: 3.1.0 info: title: Quo Public API version: 1.0.0 description: API for connecting with Quo. contact: name: Quo Support email: support@quo.com url: https://support.quo.com/ termsOfService: https://www.quo.com/terms servers: - description: Production server url: https://api.quo.com security: - apiKey: [] tags: - description: Operations related to calls name: Calls - description: >- Operations related to call summaries, including AI-generated summaries and Sona voice assistant summaries name: Call Summaries - description: >- Operations related to call transcripts, including AI-generated transcripts and Sona voice assistant transcripts name: Call Transcripts - description: Operations related to contacts name: Contacts - description: Operations related to conversations name: Conversations - description: Operations related to text messages name: Messages - description: Operations related to phone numbers name: Phone Numbers - description: Operations related to users name: Users - description: Operations related to webhooks name: Webhooks paths: /webhooks/{webhookId}/events: get: tags: - Webhooks summary: List deliveries for a webhook description: >- 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. operationId: listHeaderVersionedWebhookDeliveries parameters: - in: path name: webhookId required: true schema: description: The unique identifier of a webhook examples: - '123' pattern: ^[0-9]+$ type: string example: '123' - in: query name: limit required: false schema: description: Max number of items to return per page. default: 10 maximum: 50 minimum: 1 type: integer - in: query name: after required: false schema: examples: - eyJsYXN0SWQiOiJVU211a09NaXBhIn0 type: string example: eyJsYXN0SWQiOiJVU211a09NaXBhIn0 - in: query name: status required: false schema: type: string enum: - success - pending - sending - failed description: >- 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. examples: - success example: success - in: query name: eventTypes required: false schema: minItems: 1 description: Restrict results to deliveries of these event types. examples: - - message.received type: array items: type: string enum: - 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 description: Event type examples: - call.completed example: - message.received - in: query name: createdBefore required: false schema: description: Only include deliveries dispatched before this ISO 8601 timestamp. examples: - '2026-01-02T00:00:00Z' format: date-time type: string example: '2026-01-02T00:00:00Z' - in: query name: createdAfter required: false schema: description: Only include deliveries dispatched after this ISO 8601 timestamp. examples: - '2026-01-01T00:00:00Z' format: date-time type: string example: '2026-01-01T00:00:00Z' - in: header name: Quo-Api-Version required: true schema: type: string enum: - '2026-03-30' description: 'API version header. Supported values: 2026-03-30' responses: '200': description: OK content: application/json: schema: type: object required: - data - nextCursor properties: data: type: array items: type: object required: - id - eventType - status - nextAttemptAt - createdAt properties: id: description: The unique identifier of the delivered event. examples: - msg_2abcDEFghiJKLmnoPQRstu type: string example: msg_2abcDEFghiJKLmnoPQRstu eventType: description: >- The event type that was delivered. Typically one of `call.answered`, `call.completed`, `call.menu.selected`, `call.ringing`, `call.recording.completed`, `call.summary.completed`, `call.transcript.completed`, `message.received`, `message.delivered`, `message.failed`, `message.undelivered`, `contact.updated`, `contact.deleted`. `message.failed` indicates a send failure (retriable unless an error code marks it permanent), while `message.undelivered` indicates the message could not be delivered to the recipient or was blocked, and cannot be retried. Legacy webhooks may return other stored names. examples: - message.received type: string example: message.received status: type: string enum: - success - pending - sending - failed description: >- 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. examples: - success example: success nextAttemptAt: anyOf: - description: >- The next scheduled retry time in ISO 8601 format. `null` when no further attempts are scheduled (terminal states). examples: - '2026-01-01T00:05:00Z' format: date-time type: string example: '2026-01-01T00:05:00Z' - type: 'null' createdAt: description: >- The date the event was dispatched at, in ISO 8601 format. examples: - '2026-01-01T00:00:00Z' format: date-time type: string example: '2026-01-01T00:00:00Z' nextCursor: anyOf: - examples: - eyJsYXN0SWQiOiJVU211a09NaXBhIn0 type: string example: eyJsYXN0SWQiOiJVU211a09NaXBhIn0 - type: 'null' '400': description: Invalid Id content: application/json: schema: type: object required: - message - code - status - docs - title - description properties: message: type: string code: const: '0303400' type: string status: const: 400 type: number docs: const: https://quo.com/docs type: string title: const: Invalid Id type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string description: const: Invalid Id type: string example: 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]+$ '401': description: Unauthorized content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0300401' type: string status: const: 401 type: number docs: const: https://quo.com/docs type: string title: const: Unauthorized type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: You are unauthorized to access the webhook docs: https://quo.com/docs title: Unauthorized '403': description: Forbidden content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0300403' type: string status: const: 403 type: number docs: const: https://quo.com/docs type: string title: const: Forbidden type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: You are forbidden to access the webhook docs: https://quo.com/docs title: Forbidden '404': description: Not Found content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0300404' type: string status: const: 404 type: number docs: const: https://quo.com/docs type: string title: const: Not Found type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: Webhook with ID 123 not found docs: https://quo.com/docs title: Not Found '500': description: Unknown Error content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0301500' type: string status: const: 500 type: number docs: const: https://quo.com/docs type: string title: const: Unknown type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: An unknown error occurred docs: https://quo.com/docs title: Unknown Error security: - apiKey: [] components: securitySchemes: apiKey: in: header name: Authorization type: apiKey ````