---
title: "List outbox events"
method: GET
path: "/v1/delivery/events"
tags: ["Delivery"]
---

# List outbox events

`GET /v1/delivery/events`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/delivery/events`
- Auth: HTTP bearer

Raw outbox rows with their processing status. Filter by `event_type` —
pagination via `limit` / `offset`.

## Query parameters

- `event_type` string
- `limit` integer
- `offset` integer

## Response `200`

Paged list of outbox events.

- object
  - `items` DeliveryEvent[]
    - `id` string, required: BIGSERIAL (string-encoded to avoid JS number precision loss).
    - `customer_id` string, uuid, required
    - `event_type` string, required
    - `payload` object, required: Entity IDs only — deliverable resolvers load content at delivery time.
    - `dedup_key` string, nullable
    - `created_at` string, date-time, required
    - `processed_at` string, date-time, nullable
    - `processing_attempts` integer, required
    - `processing_status` 'enqueued' | 'no-subscribers' | 'failed', nullable
    - `error` string, nullable
  - `total` integer

## Other responses

- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)