---
title: "Create a Batch of Labels"
method: POST
path: "/2024-09/batches/labels"
tags: ["Batches"]
---

# Create a Batch of Labels

`POST /2024-09/batches/labels`

Create a batch of labels.

Required authorization scopes: `public.batch:write`, `public.label:write`

Labels confirm a shipment created with the Shipment API. Calling **Batch Labels** will confirm shipments with selected courier service and begin generating the label and shipping documents if your account balance is sufficient.

> You can enter a `courier_service_id` to assign a specific courier service in case your shipment has no assigned courier yet, or you need to overwrite the one suggested by default. Your shipment will be confirmed. If there is no assigned courier service and you leave the `courier_service_id` field blank, we will automatically assign the best value for money courier to your shipment.

## Asynchronous response

The label and shipping documents will be generated asynchronously. If you specified a `Callback URL` through the Easyship dashboard, this URL will be called when the documents are ready.
Whilst these documents are being generated, the `label_state` will be set to `pending`. The possible states are `not_created`, `pending`, `failed` and `generated`.

## Request body

- BatchLabelsCreate — Batch Labels Create
  - `shipments` object[], required
    - `easyship_shipment_id` EasyshipShipmentId, required — unresolved $ref
    - `courier_service_id` string, uuid — Courier service ID in case you need to overwrite the one suggested by default

## Response `202`

batch successfully created

- BatchSingle — Batch
  - `batch` BatchSingle — recursive
  - `meta` Meta
    - `request_id` string — An unique ID represent the request.

## Other responses

- `402` — overdraft limit exceeded
- `403` — identity verification required
- `422` — missing params

---

[API](https://skmtc.net/easyship/apis/easyship-public-api.md) · [All operations](https://skmtc.net/easyship/apis/easyship-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easyship/easyship-public-api/revisions/71d737a5fcbf/schema)