---
title: "Create a return shipment"
method: POST
path: "/returns"
tags: ["Returns"]
---

# Create a return shipment

`POST /returns`

Creates a return label and returns shipment details including tracking number, QR code, and label.

## Request body

- CreateReturnRequest
  - `service` ServiceCode, required
    - `serviceCode` string, required — Return service code. Obtain available values from GET /returns/services.
    - `serviceRegisterCode` string
  - `shipment` Shipment, required
    - `shippingAddress` Address, required
      - `title` string
      - `firstName` string, required
      - `lastName` string, required
      - `companyName` string
      - `addressLine1` string, required
      - `addressLine2` string
      - `addressLine3` string
      - `city` string, required
      - `county` string
      - `postcode` string, required
      - `country` string, required
      - `countryIsoCode` string, required — ISO 3166-1 alpha-3 country code (e.g. GBR, USA)
    - `returnAddress` Address, required
      - `title` string
      - `firstName` string, required
      - `lastName` string, required
      - `companyName` string
      - `addressLine1` string, required
      - `addressLine2` string
      - `addressLine3` string
      - `city` string, required
      - `county` string
      - `postcode` string, required
      - `country` string, required
      - `countryIsoCode` string, required — ISO 3166-1 alpha-3 country code (e.g. GBR, USA)
    - `customerReference` CustomerReference
      - `reference` string, required

## Response `200`

Successfully created return shipment

- CreateReturnResponse
  - `shipment` object
    - `trackingNumber` string
    - `uniqueItemId` string
  - `qrCode` string
  - `label` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/royalmail/apis/channelshipper-royal-mail-public-api.md) · [All operations](https://skmtc.net/royalmail/apis/channelshipper-royal-mail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/royalmail/channelshipper-royal-mail-public-api/versions/7e0c23c81719/schema)