# List deliveries `GET https://api.parasend.com/v1/deliveries` Source: https://parasend.com/docs/api/deliveries/list Authentication: `Authorization: Bearer ` (a `ps_test_` key in test mode, `ps_live_` in live mode). Lists your deliveries a page at a time (`limit`, `cursor`). Each row carries its `kind`. `status` is where a delivery is in its life; activity such as reminders and opens is in `last_activity`, never in `status`. ## Query parameters - `q` (string, optional): Free text, 2–200 characters, matched case-insensitively as part of the delivery title, the recipient's name or the recipient's e-mail, or exactly against a delivery id. Never matches personal codes or phone numbers — use `pin` for a personal code. `%` and `_` are ordinary characters. - `pin` (string, optional): The recipient's personal code (e.g. kennitala), exact match only; spaces and hyphens are ignored (120389-4569 = 1203894569). A part of a code matches nothing. - `recipient_email` (string · email, optional): The recipient's e-mail address, exact match, case-insensitive. - `created_before` (string · date-time, optional): Only deliveries created strictly before this time. With `created_after`, a date range. - `sort` (string, optional): `created_desc` (default) newest first; `created_asc` oldest first; `title_asc` / `title_desc` by title, case-insensitive; `recipient_asc` / `recipient_desc` by the recipient's name, else e-mail, else phone, case-insensitive; `status_asc` / `status_desc` by status in lifecycle order — on its way (created, paper_pending_approval, notified, paper_dispatched, opened, authenticated, auth_failed), then received (confirmed, delivered, evidence_sealed), then ended without delivery (expired, revoked, bounced, consignment_failed). Within one title, recipient or status the newest comes first. A cursor is only valid with the sort it was issued under (otherwise invalid_request / cursor_invalid). One of: `created_desc`, `created_asc`, `title_asc`, `title_desc`, `status_asc`, `status_desc`, `recipient_asc`, `recipient_desc`. Default: `"created_desc"`. ## Example: List deliveries ```bash curl "https://api.parasend.com/v1/deliveries" \ -H "Authorization: Bearer $PARASEND_KEY" ``` ```js const res = await fetch('https://api.parasend.com/v1/deliveries', { method: 'GET', headers: { Authorization: `Bearer ${process.env.PARASEND_KEY}`, }, }); const data = await res.json(); ``` ## Response 200 Paginated list. ```json { "data": [ { "id": "dlv_01M6R27T1MRPH7P4ZSR0WKTBQD", "object": "delivery", "kind": "documents", "direction": "outbound", "content_type": "files", "status": "notified", "last_activity": { "at": "2026-11-06T09:15:05.675Z", "type": "notified" }, "title": "Terms of your loan are changing", "message": null, "language": "en", "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": "+3540000000", "address": null, "verification_level": "medium", "conditional_authentication": false, "personal_code": null, "id_document_number": null }, "files": [ { "file_id": "fil_01M6R27SZK99V6N6WG4GK15T6R", "path": "test-notice.pdf", "primary": true } ], "batch_id": null, "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_01M6R27T1MZJTGQZYDP9MF2ZGT", "private": false, "options": { "auth_methods": [ "sms_otp", "audkenni", "smart_id", "passkey", "videoid" ], "reminder_policy": null, "brand_profile_id": null, "expires_in_days": 14, "sender_display": "legal_person", "notify_channels": [ "email", "sms" ] }, "legal_hold": false, "deletion_scheduled_at": null, "livemode": false, "created": "2026-11-06T09:15:05.651Z", "expires_at": "2026-11-20T09:15:05.651Z", "metadata": {}, "origin_request": null, "reminder_waiting": null, "email_waiting": null, "follow_up": { "policy_id": null, "policy_name": null, "policy_source": "none", "state": "done", "reminders_sent": 0, "last_step": null, "next_step": null, "paused": false } }, { "id": "dlv_01M6R27T13NKWVJRJBTHZDP6Y1", "object": "delivery", "kind": "documents", "direction": "outbound", "content_type": "files", "status": "notified", "last_activity": { "at": "2026-11-06T09:15:05.671Z", "type": "notified" }, "title": "Court summons", "message": null, "language": "en", "certificate_language": "is", "recipient": { "name": "Gervimaður Eyjaálfa", "verified_name": null, "verified_method": null, "verification_photos": [], "email": "gervimadur@example.com", "phone": null, "address": null, "verification_level": "high", "conditional_authentication": true, "personal_code": "0101304339", "id_document_number": null }, "files": [ { "file_id": "fil_01M6R27SZK99V6N6WG4GK15T6R", "path": "test-notice.pdf", "primary": true } ], "batch_id": null, "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_01M6R27T1389NCD4SG4VXJKZAJ", "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.634Z", "expires_at": "2026-12-06T09:15:05.634Z", "metadata": {}, "origin_request": null, "reminder_waiting": null, "email_waiting": null, "follow_up": { "policy_id": null, "policy_name": null, "policy_source": "none", "state": "done", "reminders_sent": 0, "last_step": null, "next_step": null, "paused": false } }, { "id": "dlv_01M6R27T05512SCV3852TPM2XY", "object": "delivery", "kind": "documents", "direction": "outbound", "content_type": "files", "status": "notified", "last_activity": { "at": "2026-11-06T09:15:05.667Z", "type": "notified" }, "title": "Final notice: invoice 2026-114", "message": null, "language": "en", "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": null, "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_01M6R27T05ZNSRNMAW2CA8MTF6", "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.604Z", "expires_at": "2026-12-06T09:15:05.603Z", "metadata": { "case_ref": "IN-2026-114" }, "origin_request": null, "reminder_waiting": null, "email_waiting": null, "follow_up": { "policy_id": null, "policy_name": null, "policy_source": "none", "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.