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

# List the delivery log

`GET /webhooks/deliveries`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/webhooks/deliveries`
- Auth: API key in header `X-Axilio-Api-Key`

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.
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `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-23** `49b1da5a7974`: 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-09-27** `7abfd1e84b24`: 1 info
  - endpoint added

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

---

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