deliveries

List deliveries (the outbox)

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.

get/v1/deliveries

Request

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

Query parameters

cursorstring
limitinteger
statusstring

Filter by status: pending, sending, sent, failed, dead or skipped.

routestring

Filter to one route id.

destinationstring

Filter to one destination id.

submissionstring

Filter to one submission id.

Response

ok

next_cursorstring nullable required

Example response

{
  "data": [
    {
      "id": "fm_8f3kq2",
      "submission_id": "fm_8f3kq2",
      "route_id": "fm_8f3kq2",
      "destination_id": "fm_8f3kq2",
      "next_attempt_at": "2026-08-21T09:00:00.000Z",
      "created_at": "2026-08-21T09:00:00.000Z",
      "sent_at": "2026-08-21T09:00:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.