---
title: "List deliveries (the outbox)"
method: GET
path: "/v1/deliveries"
tags: ["deliveries"]
---

# List deliveries (the outbox)

`GET /v1/deliveries`

## Request

- Base URL: `https://postbag.dev`
- URL: `https://postbag.dev/v1/deliveries`
- Auth: HTTP bearer

A submission is a row before it is anything else; delivery is this outbox drained by a worker. Poll here to confirm a submission actually arrived at its destination.

## Query parameters

- `cursor` string
- `limit` integer
- `status` string: Filter by status: pending, sending, sent, failed, dead or skipped.
- `route` string: Filter to one route id.
- `destination` string: Filter to one destination id.
- `submission` string: Filter to one submission id.

## Response `200`

ok

- object
  - `data` Delivery[], required
    - `id` string, required
    - `submission_id` string, required
    - `route_id` string, required
    - `destination_id` string, required
    - `status` 'pending' | 'sending' | 'sent' | 'failed' | 'dead' | 'skipped', required
    - `skip_reason` string, nullable, required
    - `attempts` integer, required
    - `next_attempt_at` string, nullable, required
    - `schema_version` integer, nullable, required
    - `payload` object, required
    - `last_response` DeliveryResult
      - `ok` boolean
      - `status_code` integer, nullable
      - `latency_ms` number
      - `response_excerpt` string
      - `error` string, nullable
    - `last_error` string, nullable, required
    - `created_at` string, required
    - `sent_at` string, nullable, required
  - `next_cursor` string, nullable, required

---

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