---
title: "Add shipments to a batch"
method: POST
path: "/client/batch/{batchNumber}/addShipment"
tags: ["Batches"]
---

# Add shipments to a batch

`POST /client/batch/{batchNumber}/addShipment`

Adds one or more purchased shipments to an existing batch. Each shipment can only belong to one batch — adding a shipment already in another batch moves it.

## Path parameters

- `batchNumber` string, required

## Request body

- BatchShipmentsRequest
  - `shipments` string[], required — List of order numbers.

## Response `200`

Shipments added or error

- object
  - `message` string, required — Additional information about the request status.
  - `code` integer, required — Status code. 0 indicates success.
  - `data` BatchMutationResponseData — Partial batch summary returned after add/remove shipment operations.
    - `batchNumber` string, required
    - `batchName` string, nullable
    - `status` 'PENDING' | 'PICKUP_REQUESTED' | 'PICKUP_CANCELLED' | 'PARTNER_RECEIVED' | 'PICKED_UP' | 'RECEIVED', required — Batch status.
    - `printedLabel` boolean, required
    - `shipmentCount` integer, required

---

[API](https://skmtc.dev/uniuni/apis/uniuni-platform-client-api.md) · [All operations](https://skmtc.dev/uniuni/apis/uniuni-platform-client-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uniuni/uniuni-platform-client-api/revisions/d61334c7f8b1/schema)