# One delivery, with the event as it was sent

HTML: https://www.app2email.com/docs/api/webhooks/get-webhook-delivery · Index: https://www.app2email.com/docs/api/llms.txt

`GET https://api.app2email.com/v1/{number}/webhooks/{id}/deliveries/{event_id}` · scope `webhooks:manage`

Every try, and next_attempt_at while a retry is planned. event_body only with a key that also has messages:read.

```shell
curl "https://api.app2email.com/v1/YOUR_NUMBER/webhooks/wh_a1b2c3d4e5f6g7h8/deliveries/evt_Xq3k9m2" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## OpenAPI

```json
{
  "/v1/{number}/webhooks/{id}/deliveries/{event_id}": {
    "get": {
      "tags": [
        "Webhooks"
      ],
      "operationId": "getWebhookDelivery",
      "summary": "One delivery, with the event as it was sent",
      "parameters": [
        {
          "$ref": "#/components/parameters/Number"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "description": "The webhook's id.",
          "schema": {
            "type": "string",
            "example": "wh_a1b2c3d4e5f6g7h8"
          }
        },
        {
          "name": "event_id",
          "in": "path",
          "required": true,
          "description": "The event's id (X-App2email-Delivery, or 'id' in the event).",
          "schema": {
            "type": "string",
            "example": "evt_Xq3k9m2"
          }
        }
      ],
      "responses": {
        "200": {
          "description": "The delivery.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookDeliveryResponse"
              },
              "example": {
                "success": true,
                "request_id": "y5wdn",
                "delivery": {
                  "event_id": "evt_Xq3k9m2",
                  "type": "message.status",
                  "created": "2026-10-26T01:12:11Z",
                  "delivered": false,
                  "attempts": [
                    {
                      "at": "2026-10-26T01:12:11Z",
                      "ok": false,
                      "http_status": 503,
                      "ms": 2001,
                      "error": "timeout"
                    }
                  ],
                  "event_body": {
                    "id": "evt_Xq3k9m2",
                    "type": "message.status",
                    "created": "2026-10-26T01:12:11Z",
                    "number": "4976659348270",
                    "data": {
                      "message_id": "wamid.HBgLNjE0MTIzNDU2NzgVAgARGBJTQU1QTEVfVEVTVF9FVkVOVAA=",
                      "to": "61412345678",
                      "status": "delivered",
                      "timestamp": "2026-10-26T01:12:11Z"
                    }
                  }
                }
              }
            }
          }
        },
        "401": {
          "description": "Missing, invalid, revoked or expired API key. Possible error.code values: missing_api_key, invalid_authorization_header, invalid_api_key, api_key_old_format, api_key_revoked, api_key_expired.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ErrorResponse"
              }
            }
          }
        },
        "403": {
          "description": "The key is valid but this call is not allowed: the key lacks the scope the call needs (insufficient_scope), the address is not allowed for the key (ip_not_allowed), the number or plan does not allow it, a recipient opted out or is not opted in, or a problem with the WhatsApp account. Possible error.code values: api_key_number_mismatch, insufficient_scope, ip_not_allowed, plan_not_allowed, service_not_live, recipient_opted_out, recipient_not_opted_in, template_name_reserved, whatsapp_payment_issue, whatsapp_account_locked, whatsapp_account_restricted, sandbox_key, recipient_stopped_marketing, messaging_limit_restricted, display_name_not_approved, username_not_eligible, account_not_confirmed, account_deactivated, booking_not_enabled, link_not_usable, call_permission_required, not_in_instant_sandbox, flow_blocked_by_integrity, whatsapp_permission_missing, partner_suspended, partner_closed, client_not_editable, shop_not_enabled, submit_not_enabled, tickets_not_enabled.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ErrorResponse"
              }
            }
          }
        },
        "404": {
          "description": "The number, template, message, broadcast, webhook, delivery, opt-in, logged request, booking or Flow was not found. Possible error.code values: number_not_found, template_not_found, template_language_not_found, message_not_found, broadcast_not_found, webhook_not_found, delivery_not_found, optin_not_found, request_not_found, conversation_not_found, contact_not_found, segment_not_found, approval_not_found, media_not_found, route_not_found, key_not_found, dataset_not_found, waitlist_not_found, booking_not_found, block_not_found, note_not_found, link_not_found, hold_not_found, flow_not_found, flow_json_not_found, qr_code_not_found, client_not_found, payment_not_found, package_not_found, poll_not_found, shop_not_found, form_not_found, submission_not_found, automation_not_found, connection_not_found, member_not_found, list_not_found, ticket_event_not_found, ticket_date_not_found, ticket_type_not_found, ticket_order_not_found, ticket_not_found, ticket_code_not_found, ticket_check_in_not_found, catcher_not_found.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ErrorResponse"
              }
            }
          }
        },
        "429": {
          "description": "A monthly plan limit, the number's own monthly cap, the key's daily cap, a WhatsApp rate limit, the API rate limit (rate_limited), or the webhook test limit (too_many_tests) was reached. Retry-After and error.retry_after_seconds say how long to wait. Possible error.code values: monthly_limit_reached, too_many_messages_to_recipient, whatsapp_rate_limit, rate_limited, daily_cap_reached, monthly_cap_reached, too_many_tests, register_limit_reached, too_many_signups, media_lookups_paused, too_many_invites.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ErrorResponse"
              }
            }
          }
        },
        "500": {
          "description": "Unexpected error on app2email's side. Possible error.code values: internal_error, background_start_failed, schedule_failed, shop_failed.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ErrorResponse"
              }
            }
          }
        }
      },
      "description": "Every try, and next_attempt_at while a retry is planned. event_body only with a key that also has messages:read.",
      "x-a2e-scope": "webhooks:manage",
      "x-a2e-sandbox": "read",
      "x-a2e-error-codes": [
        "api_key_expired",
        "api_key_number_mismatch",
        "api_key_old_format",
        "api_key_revoked",
        "delivery_not_found",
        "insufficient_scope",
        "internal_error",
        "invalid_api_key",
        "invalid_authorization_header",
        "invalid_number_in_url",
        "ip_not_allowed",
        "missing_api_key",
        "number_not_found",
        "plan_not_allowed",
        "rate_limited",
        "service_not_live",
        "webhook_not_found"
      ],
      "x-a2e-webhook-events": [],
      "x-a2e-mcp-tool": null,
      "x-a2e-needs": null
    }
  }
}
```
