Set the recipient's postal address

PATCH/v1/deliveries/{id}/address

For the paper escalation channel. Rejected after paper dispatch or in terminal states (409 address_patch_state_invalid).

Path parameters

idstringrequired

The delivery's ID, starting dlv_.

Body

Optional

line1string

The first address line, such as the street and number. Required.
line2string · nullable

A second address line, or null.
postal_codestring

The postal code. Required.
citystring

The town or city. Required.
countrystring

ISO 3166-1 alpha-2
sourcestring · nullable

Where the address came from, as you state it: thjodskra, Iceland's national registry (Þjóðskrá); customer_csv, your own records, imported from a file; manual, entered by hand. Default manual.
One of thjodskra customer_csv manual

Returns

200 application/json. Updated delivery. See the Delivery object.

Errors have one shape; see Errors for every code.

Code language

Request

curl -X PATCH "https://api.parasend.com/v1/deliveries/dlv_01M6R27T05512SCV3852TPM2XY/address" \
  -H "Authorization: Bearer $PARASEND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "line1": "Akralind 3",
    "postal_code": "201",
    "city": "Kópavogur",
    "country": "IS"
  }'

const res = await fetch('https://api.parasend.com/v1/deliveries/dlv_01M6R27T05512SCV3852TPM2XY/address', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    line1: 'Akralind 3',
    postal_code: '201',
    city: 'Kópavogur',
    country: 'IS',
  }),
});
const data = await res.json();

import os, requests

res = requests.patch(
    "https://api.parasend.com/v1/deliveries/dlv_01M6R27T05512SCV3852TPM2XY/address",
    headers={
        "Authorization": f"Bearer {os.environ['PARASEND_KEY']}",
    },
    json={
        "line1": "Akralind 3",
        "postal_code": "201",
        "city": "Kópavogur",
        "country": "IS",
    },
)
data = res.json()

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Patch, "https://api.parasend.com/v1/deliveries/dlv_01M6R27T05512SCV3852TPM2XY/address");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PARASEND_KEY"));
request.Content = new StringContent("""
{
  "line1": "Akralind 3",
  "postal_code": "201",
  "city": "Kópavogur",
  "country": "IS"
}
""", Encoding.UTF8, "application/json");
var response = await http.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

var json = """
    {
      "line1": "Akralind 3",
      "postal_code": "201",
      "city": "Kópavogur",
      "country": "IS"
    }
    """;
var request = HttpRequest.newBuilder(URI.create("https://api.parasend.com/v1/deliveries/dlv_01M6R27T05512SCV3852TPM2XY/address"))
    .header("Authorization", "Bearer " + System.getenv("PARASEND_KEY"))
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString(json))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

$client = new GuzzleHttp\Client();
$response = $client->request('PATCH', 'https://api.parasend.com/v1/deliveries/dlv_01M6R27T05512SCV3852TPM2XY/address', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'),
    ],
    'json' => [
        'line1' => 'Akralind 3',
        'postal_code' => '201',
        'city' => 'Kópavogur',
        'country' => 'IS',
    ],
]);
$data = json_decode($response->getBody(), true);

Response · 200

{
  "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": {
      "city": "Kópavogur",
      "line1": "Akralind 3",
      "line2": null,
      "source": "manual",
      "country": "IS",
      "postal_code": "201"
    },
    "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
  }
}