---
title: "List delivery attempt records"
method: GET
path: "/v1/delivery/items"
tags: ["Delivery"]
---

# List delivery attempt records

`GET /v1/delivery/items`

## Request

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

One row per delivery attempt. Filter by `binding_id`, `destination_id`,
and/or `status` (`in_flight` | `succeeded` | `failed`). Paginated via
`limit` / `offset` (default 50 / 0).

## Query parameters

- `binding_id` string, uuid
- `destination_id` string, uuid
- `status` 'in_flight' | 'succeeded' | 'failed' | 'superseded'
- `limit` integer
- `offset` integer

## Response `200`

Paged list of delivery items.

- object
  - `items` DeliveryItem[]
    - `id` string, uuid, required
    - `customer_id` string, uuid, required
    - `binding_id` string, uuid, required
    - `event_id` string, required: BIGSERIAL id of the originating outbox row (string-encoded).
    - `idempotency_key` string, required: SHA-256-derived key passed on the wire. Stable within an attempt.
    - `status` 'in_flight' | 'succeeded' | 'failed' | 'superseded', required
    - `attempt` integer, required
    - `http_status` integer, nullable
    - `error_code` string, nullable
    - `error_message` string, nullable
    - `request_body` string, nullable
    - `response_body` string, nullable
    - `duration_ms` integer, nullable
    - `completed_at` string, date-time, nullable
    - `created_at` string, date-time, required
  - `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)