---
title: "Update order shipping address"
method: PATCH
path: "/orders/shipping-address/{id}"
tags: ["Order Controller"]
---

# Update order shipping address

`PATCH /orders/shipping-address/{id}`

Updates shipping recipient name, phone, and address fields. Only include fields you want to change; at least one field is required.

## Path parameters

- `id` number, required

## Request body

- UpdateOrderShippingAddressDto
  - `shippingAddress1` string — Shipping address line 1
  - `shippingAddress2` string — Shipping address line 2
  - `shippingCity` string — Shipping city
  - `shippingPostcode` string — Shipping postcode
  - `shippingCounty` string — Shipping county
  - `shippingPhone` string — Shipping phone number
  - `shippingFirstName` string — Shipping first name
  - `shippingLastName` string — Shipping last name
  - `updateItWithAllLinkedOrders` boolean — Update shipping address for all linked orders

## Response `200`

Shipping address updated successfully

- OrderCreateUpdateResponseDto
  - `orderId` number, required — Order ID
  - `customerEmail` string, required — Customer email
  - `emailValid` boolean, required — Email valid
  - `emailValidationStatus` string — Email validation status (UNKNOWN, VALID, INVALID)
  - `isNewCustomer` boolean — True if customer was auto-created during this order
  - `documentAccessLink` string — Permanent document access link

## Other responses

- `400` — No shipping fields supplied or invalid payload
- `404` — Order not found

---

[API](https://skmtc.dev/findmydocument/apis/land-registry-api.md) · [All operations](https://skmtc.dev/findmydocument/apis/land-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/findmydocument/land-registry-api/revisions/b55a990514fb/schema)