---
title: "List the delivery log"
method: GET
path: "/webhooks/deliveries"
tags: ["Webhooks"]
---

# List the delivery log

`GET /webhooks/deliveries`

## Request

- Base URL: `https://api.axilio.ai/api/v1`
- URL: `https://api.axilio.ai/api/v1/webhooks/deliveries`
- Auth: API key in header `X-Axilio-Api-Key`
- TypeScript: <https://skmtc.dev/axilioai/apis/axilio-api-2/docs/webhooks/deliveries/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists events published for the caller's organization, newest first, one page at a time. Narrow it to one event type (event_type), one destination (endpoint_id) or one message's events (message_id). Pass the response's next_cursor as cursor to fetch the following page.

## Query parameters

- `limit` integer: Page size.
- `cursor` string: Opaque cursor from a previous page's next_cursor. Omit for the first page.
- `event_type` string: Restrict the log to one event type. Omit for all types.
- `endpoint_id` string: Restrict the log to deliveries to one destination (endpoint id). Omit for all destinations.
- `message_id` string, uuid: Restrict the log to the events for one message: message.received for a received message, the status events (message.sent, message.delivered, message.failed, message.unconfirmed) for a sent one, and the deletion events (message.deleted, message.phone_deleted, message.phone_delete_failed) for a deleted one. Omit for every event.

## Response `200`

OK

- WebhookDeliveryListResponse: One page of the organization's delivery log.
  - `deliveries` WebhookDelivery[], nullable, required: Delivery-log events on this page, newest first.
    - `endpoint_ids` string[], nullable, required: Endpoints the event was routed to: the subscribers of its type at publish time, or the one endpoint a targeted test named. Empty when none was subscribed.
    - `event_id` string, required: Event identifier.
    - `event_type` string, required: Event type the event was published to.
    - `published_at` string, date-time, required: Timestamp when the event was published.
  - `next_cursor` string, nullable, required: Opaque cursor for the next page (pass as the cursor query parameter). Null when this is the last page.

## Other responses

- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-10-24** `ecca093572e0`: 3 info
  - added the new optional `query` request parameter `message_id`
  - added the non-success response with the status `422`
  - added the non-success response with the status `500`
- **2026-10-17** `f732df58a578`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axilioai/apis/axilio-api-2/changes/webhooks/deliveries/get.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) - [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/axilioai/apis/axilio-api-2/revisions/62aa324803a7?raw)