---
title: "Retrieve a batch"
method: GET
path: "/client/batch/{batchNumber}"
tags: ["Batches"]
---

# Retrieve a batch

`GET /client/batch/{batchNumber}`

Retrieves detailed information about a specific batch, including its list of shipment order numbers.

## Path parameters

- `batchNumber` string, required

## Response `200`

Batch details or error

- object
  - `message` string, required — Additional information about the request status.
  - `code` integer, required — Status code. 0 indicates success.
  - `data` BatchResponseData
    - `batchNumber` string, required — Unique batch identifier.
    - `batchName` string, nullable — Batch name.
    - `status` 'PENDING' | 'PICKUP_REQUESTED' | 'PICKUP_CANCELLED' | 'PARTNER_RECEIVED' | 'PICKED_UP' | 'RECEIVED', required — Batch status.
    - `printedLabel` boolean, required — Whether the batch label has been printed.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `shipmentCount` integer, required — Number of shipments in the batch.
    - `shipments` string[] — List of shipment order numbers.

---

[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)