> ## Documentation Index > Fetch the complete documentation index at: https://sendmux.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # List webhook delivery attempts > Returns recent delivery attempts for one webhook subscription, ordered by `created_at` descending. Delivery metadata is retained for 7 days. Use the payload endpoint while `payload_available` is true to inspect the exact JSON request body that was delivered. ## OpenAPI ````yaml /openapi-app.json get /webhooks/{public_id}/deliveries openapi: 3.1.0 info: description: Programmatic access to your Sendmux email infrastructure. title: Sendmux API version: 1.0.0 servers: - description: API v1 url: https://app.sendmux.ai/api/v1 security: - bearerAuth: [] paths: /webhooks/{public_id}/deliveries: get: tags: - Webhooks summary: List webhook delivery attempts description: >- Returns recent delivery attempts for one webhook subscription, ordered by `created_at` descending. Delivery metadata is retained for 7 days. Use the payload endpoint while `payload_available` is true to inspect the exact JSON request body that was delivered. operationId: managementListDelivery parameters: - in: path name: public_id required: true schema: description: Webhook public ID type: string - in: query name: cursor required: false schema: description: Pagination cursor — the `next_cursor` from the previous response. type: string - in: query name: limit required: false schema: description: Maximum results (default 25, max 100) maximum: 100 minimum: 1 type: integer - in: query name: event_type required: false schema: description: Filter by event type. enum: - message.delivered - message.bounced - message.complained - message.rejected - message.delivery_delayed - message.received - message.received.spam - sendmux.test example: message.bounced type: string - in: query name: result required: false schema: description: Filter by delivery result. enum: - success - retrying - failed - permanent_failure type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/WebhookDeliveryAttemptCursorListResponse' description: Delivery-attempt list '400': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Invalid query parameter '401': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Authentication required '403': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Insufficient permissions '404': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Subscription not found security: - bearerAuth: [] components: schemas: WebhookDeliveryAttemptCursorListResponse: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - properties: data: items: $ref: '#/components/schemas/WebhookDeliveryAttempt' type: array meta: $ref: '#/components/schemas/ResponseMeta' pagination: $ref: '#/components/schemas/CursorPagination' required: - data - pagination type: object unevaluatedProperties: false ApiError: additionalProperties: false properties: error: additionalProperties: false properties: code: description: Machine-readable error code enum: - invalid_parameter - missing_parameter - authentication_required - insufficient_permissions - not_found - conflict - limit_exceeded - idempotency_conflict - payload_too_large - validation_error - rate_limit_exceeded - service_unavailable - internal_error example: invalid_parameter type: string doc_url: description: Link to relevant documentation type: string errors: description: >- Accumulated per-field issues for validation errors. Only present on 400/422 responses. items: $ref: '#/components/schemas/ApiErrorDetail' type: array message: description: Human-readable error description type: string param: description: The parameter that caused the error type: string retryable: description: >- Whether the caller may safely retry this request. 4xx are typically false (except 429); 5xx are typically true. example: false type: boolean required: - code - message - retryable type: object meta: additionalProperties: false properties: request_id: example: req_clxxxxxxxxxxxxxxxxxxxxxxxxx type: string required: - request_id type: object ok: enum: - false type: boolean required: - ok - error - meta type: object SuccessEnvelope: properties: meta: additionalProperties: {} properties: {} type: object ok: enum: - true type: boolean required: - ok - meta type: object WebhookDeliveryAttempt: additionalProperties: false properties: created_at: description: ISO 8601 attempt timestamp example: '2026-05-21T09:12:00Z' type: string delivery_attempt: description: 1-based retry attempt number. example: 1 exclusiveMinimum: 0 type: integer error_message: description: >- Public-safe network error category when no HTTP response was received. example: null type: - string - 'null' event_id: description: Webhook event ID example: evt_clxxxxxxxxxxxxxxxxxxxxxxxxx type: string event_type: description: >- Event types a webhook may subscribe to. `sendmux.test` is accepted so you can verify end-to-end delivery via POST /webhooks/{id}/test. enum: - message.delivered - message.bounced - message.complained - message.rejected - message.delivery_delayed - message.received - message.received.spam - sendmux.test example: message.bounced type: string id: description: Delivery-attempt public ID example: whda_clxxxxxxxxxxxxxxxxxxxxxxxxx type: string max_attempts: description: Maximum attempts before the subscription is marked failing. example: 8 exclusiveMinimum: 0 type: integer next_retry_at: description: Next retry timestamp when result is retrying; otherwise null. example: null type: - string - 'null' payload_available: description: True while the delivered request payload can still be fetched. example: true type: boolean payload_expires_at: description: Timestamp when the retained request payload expires. example: '2026-05-28T09:12:00Z' type: string request_payload_bytes: description: Size of the delivered request payload in bytes. example: 2048 minimum: 0 type: integer request_payload_sha256: description: SHA-256 digest of the delivered request payload. example: b1946ac92492d2347c6235b4d2611184d4e4f8f2f43a5f2d8d5b7a4a6f0c1e2d type: - string - 'null' response_body: description: Truncated endpoint response preview, if any. example: ok type: - string - 'null' response_ms: description: End-to-end delivery latency in milliseconds. example: 184 minimum: 0 type: integer response_status: description: >- HTTP status returned by the endpoint, or null for network/timeout failures. example: 200 type: - integer - 'null' result: description: Delivery result for this attempt. enum: - success - retrying - failed - permanent_failure example: success type: string required: - id - event_id - event_type - result - response_status - response_ms - delivery_attempt - max_attempts - next_retry_at - error_message - response_body - payload_available - payload_expires_at - request_payload_bytes - request_payload_sha256 - created_at type: object ResponseMeta: additionalProperties: false properties: request_id: example: req_clxxxxxxxxxxxxxxxxxxxxxxxxx type: string required: - request_id type: object CursorPagination: additionalProperties: false properties: has_more: type: boolean next_cursor: type: string required: - has_more type: object ApiErrorDetail: additionalProperties: false properties: code: description: >- Machine-readable issue code from the validator (e.g. zod issue code). example: invalid_string type: string field: description: Dot-path of the offending request field. example: recipient.email type: string message: description: Human-readable issue description. type: string required: - field - code - message type: object securitySchemes: bearerAuth: bearerFormat: API Key description: >- Sendmux API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys. scheme: bearer type: http ````