List deliveries

GET/v1/deliveries

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

qstring

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.
pinstring

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_emailstring · email

The recipient's e-mail address, exact match, case-insensitive.
created_beforestring · date-time

Only deliveries created strictly before this time. With created_after, a date range.
sortstring

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"

Returns

200 application/json. Paginated list.

Errors have one shape; see Errors for every code.

Code language

Request

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

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

import os, requests

res = requests.get(
    "https://api.parasend.com/v1/deliveries",
    headers={
        "Authorization": f"Bearer {os.environ['PARASEND_KEY']}",
    },
)
data = res.json()

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.parasend.com/v1/deliveries");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PARASEND_KEY"));
var response = await http.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

var request = HttpRequest.newBuilder(URI.create("https://api.parasend.com/v1/deliveries"))
    .header("Authorization", "Bearer " + System.getenv("PARASEND_KEY"))
    .GET()
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.parasend.com/v1/deliveries', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'),
    ],
]);
$data = json_decode($response->getBody(), true);

Response · 200

{
  "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
}