---
title: "Set order status"
method: PUT
path: "/orders/status"
tags: ["Orders"]
---

# Set order status

`PUT /orders/status`

## Request body

- UpdateOrdersStatusRequest
  - `items` UpdateOrderStatusRequest[]
    - `orderIdentifier` integer
    - `orderReference` string
    - `status` 'new' | 'despatchedByOtherCourier' | 'despatched' — <br/> "<i>despatchedByOtherCourier</i> ": <b>Reserved for ChannelShipper customers only - please visit <a href="https://channelshipper.com/" target="_self">ChannelShipper.com</a> for more information</b> "<i>new</i> ": This will remove the order from its batch. Order information will not be lost during this process. Please be aware labels generated on orders which are then set to "new" (reset) are no longer valid and must be destroyed. If the order is required to be despatched after setting to "new" status, a new label must be generated to attach to the item. Cancelled label information is automatically shared with Royal Mail Revenue Protection, and should a cancelled label be identified on an item in the Royal Mail Network, you will be charged on your account and an additional handling fee applied.
    - `trackingNumber` string
    - `despatchDate` string, date-time
    - `shippingCarrier` string
    - `shippingService` string

## Response `200`

Provides a list of orders

- UpdateOrderStatusResponse
  - `updatedOrders` UpdatedOrderInfo[]
    - `orderIdentifier` integer
    - `orderReference` string
    - `status` string — Current status of the order
  - `errors` OrderUpdateError[]
    - `orderIdentifier` integer
    - `orderReference` string
    - `status` string — Current status of the order
    - `code` string
    - `message` string

## Other responses

- `400` — Bad Request (Request has missing or invalid parameters and cannot be parsed)
- `401` — Unauthorized
- `404` — Not Found
- `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/revisions/7e0c23c81719/schema)