# List a batch's deliveries

`GET https://api.parasend.com/v1/batches/{id}/deliveries`

Source: https://parasend.com/docs/api/batches/deliveries

Authentication: `Authorization: Bearer <API key>` (a `ps_test_` key in test mode, `ps_live_` in live mode).

Lists the batch's deliveries. `q` matches the title, the recipient's name or e-mail in part, or a delivery ID exactly; never a personal code or a phone number. `pin`, `recipient_email` and `phone` match exactly. With `Accept: text/csv`, every match is streamed as CSV.

## Path parameters

- `id` (string, required): The batch's ID, starting `bat_`.

## Query parameters

- `limit` (integer, optional): Default: `25`.
- `cursor` (string, optional)
- `q` (string, optional)
- `status` (string, optional): One of: `created`, `notified`, `opened`, `authenticated`, `auth_failed`, `confirmed`, `delivered`, `evidence_sealed`, `expired`, `revoked`, `bounced`, `consignment_failed`, `paper_pending_approval`, `paper_dispatched`.
- `needs_attention` (boolean, optional)
- `pin` (string, optional)
- `recipient_email` (string · email, optional)
- `phone` (string, optional): The whole number, E.164 or 7 Icelandic digits.
- `outcome` (string, optional): One of: `delivered`, `in_progress`, `unreachable`, `expired`, `revoked`, `not_matched`.
- `reminders` (integer, optional)
- `policy_source` (string, optional): One of: `batch`, `own`, `none`.
- `channel` (string, optional): One of: `email`, `sms`.
- `sort` (string, optional)

## Example: List a batch's deliveries

```bash
curl "https://api.parasend.com/v1/batches/bat_01M6R27T8SXWNM911FS53W4S9F/deliveries" \
  -H "Authorization: Bearer $PARASEND_KEY"
```

```js
const res = await fetch('https://api.parasend.com/v1/batches/bat_01M6R27T8SXWNM911FS53W4S9F/deliveries', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
  },
});
const data = await res.json();
```

## Response 200

Paginated member deliveries.

```json
{
  "data": [
    {
      "id": "dlv_01M6R27T9M7Z1HH1FADRGGMEZK",
      "object": "delivery",
      "kind": "documents",
      "direction": "outbound",
      "content_type": "files",
      "status": "created",
      "last_activity": null,
      "title": "Final notice: invoice 2026-115",
      "message": null,
      "language": "is",
      "certificate_language": "is",
      "recipient": {
        "name": "Jón Jónsson",
        "verified_name": null,
        "verified_method": null,
        "verification_photos": [],
        "email": "jon.jonsson@example.com",
        "phone": null,
        "address": null,
        "verification_level": "high",
        "conditional_authentication": false,
        "personal_code": null,
        "id_document_number": null
      },
      "files": [
        {
          "file_id": "fil_01M6R27SZK99V6N6WG4GK15T6R",
          "path": "test-notice.pdf",
          "primary": true
        }
      ],
      "batch_id": "bat_01M6R27T8SXWNM911FS53W4S9F",
      "delivery_url": null,
      "short_url": null,
      "evidence_policy": "urn:parasend:policy:evidence:standard:1",
      "sender_display": "legal_person",
      "operator_reference": "OP-7K3Q-M2",
      "recipient_ref": "rcp_01M6R27T9M3F3MJ7NMBYGW3V30",
      "private": false,
      "options": {
        "auth_methods": [
          "audkenni",
          "smart_id",
          "passkey"
        ],
        "reminder_policy": null,
        "brand_profile_id": null,
        "expires_in_days": 30,
        "sender_display": "legal_person",
        "notify_channels": [
          "email"
        ]
      },
      "legal_hold": false,
      "deletion_scheduled_at": null,
      "livemode": false,
      "created": "2026-11-06T09:15:05.908Z",
      "expires_at": null,
      "metadata": {},
      "origin_request": null,
      "reminder_waiting": null,
      "email_waiting": null,
      "follow_up": {
        "policy_id": null,
        "policy_name": null,
        "policy_source": "batch",
        "state": "done",
        "reminders_sent": 0,
        "last_step": null,
        "next_step": null,
        "paused": false
      }
    },
    {
      "id": "dlv_01M6R27T9GD2VVC1DVVE1DD6RB",
      "object": "delivery",
      "kind": "documents",
      "direction": "outbound",
      "content_type": "files",
      "status": "created",
      "last_activity": null,
      "title": "Final notice: invoice 2026-114",
      "message": null,
      "language": "is",
      "certificate_language": "is",
      "recipient": {
        "name": "Anna Björk Jónsdóttir",
        "verified_name": null,
        "verified_method": null,
        "verification_photos": [],
        "email": "anna.bjork@example.com",
        "phone": null,
        "address": null,
        "verification_level": "high",
        "conditional_authentication": false,
        "personal_code": null,
        "id_document_number": null
      },
      "files": [
        {
          "file_id": "fil_01M6R27SZK99V6N6WG4GK15T6R",
          "path": "test-notice.pdf",
          "primary": true
        }
      ],
      "batch_id": "bat_01M6R27T8SXWNM911FS53W4S9F",
      "delivery_url": null,
      "short_url": null,
      "evidence_policy": "urn:parasend:policy:evidence:standard:1",
      "sender_display": "legal_person",
      "operator_reference": "OP-7K3Q-M2",
      "recipient_ref": "rcp_01M6R27T9GVJW7HXAWJ0T5H4EM",
      "private": false,
      "options": {
        "auth_methods": [
          "audkenni",
          "smart_id",
          "passkey"
        ],
        "reminder_policy": null,
        "brand_profile_id": null,
        "expires_in_days": 30,
        "sender_display": "legal_person",
        "notify_channels": [
          "email"
        ]
      },
      "legal_hold": false,
      "deletion_scheduled_at": null,
      "livemode": false,
      "created": "2026-11-06T09:15:05.904Z",
      "expires_at": null,
      "metadata": {},
      "origin_request": null,
      "reminder_waiting": null,
      "email_waiting": null,
      "follow_up": {
        "policy_id": null,
        "policy_name": null,
        "policy_source": "batch",
        "state": "done",
        "reminders_sent": 0,
        "last_step": null,
        "next_step": null,
        "paused": false
      }
    }
  ],
  "has_more": false,
  "next_cursor": null
}
```

Errors: one shape, `{"error": {type, code, message, param, request_id}}`; every code is listed at https://parasend.com/docs/errors.