---
title: "Process Batch ID Labels"
method: POST
path: "/v1/batches/{batch_id}/process/labels"
tags: ["batches"]
---

# Process Batch ID Labels

`POST /v1/batches/{batch_id}/process/labels`

Process Batch ID Labels

## Request body

- ProcessBatchRequestBody — A process batch request body
  - `ship_date` string, date-time — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time.
  - `label_layout` '4x6' | 'letter' | 'A4' | 'A6' — The available layouts (sizes) in which shipping labels can be downloaded. The label format determines which sizes are supported. `4x6` is supported for all label formats, whereas `letter` (8.5" x 11") is only supported for `pdf` format.
  - `label_format` 'pdf' | 'png' | 'zpl' — The possible file formats in which shipping labels can be downloaded. We recommend `pdf` format because it is supported by all carriers, whereas some carriers do not support the `png` or `zpl` formats. |Label Format | Supported Carriers |--------------|----------------------------------- |`pdf` | All carriers |`png` | `fedex` <br> `stamps_com` <br> `ups` <br> `usps` |`zpl` | `access_worldwide` <br> `apc` <br> `asendia` <br> `dhl_global_mail` <br> `dhl_express` <br> `dhl_express_australia` <br> `dhl_express_canada` <br> `dhl_express_worldwide` <br> `dhl_express_uk` <br> `dpd` <br> `endicia` <br> `fedex` <br> `fedex_uk` <br> `firstmile` <br> `imex` <br> `newgistics` <br> `ontrac` <br> `rr_donnelley` <br> `stamps_com` <br> `ups` <br> `usps`
  - `display_scheme` 'label' | 'paperless' | 'label_and_paperless' — The display format that the label should be shown in.

## Response `204`

The request was successful.

- string

## Other responses

- `400` — The request contained errors.
- `404` — The specified resource does not exist.
- `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers.

## Changes

> 50 revisions in range; 1 could not be searched.

- **2026-03-26** `b81c65818a89` — 2 breaking
  - removed the enum value `label_and_qr_code` of the request property `display_scheme/allOf[subschema #1: display_scheme]/`
  - removed the enum value `qr_code` of the request property `display_scheme/allOf[subschema #1: display_scheme]/`
- **2024-10-16** `97d4f65fe53d` — 2 info
  - added the new `A4` enum value to the request property `label_layout/allOf[subschema #1: label_layout]/`
  - added the new `A6` enum value to the request property `label_layout/allOf[subschema #1: label_layout]/`
- **2024-10-08** `e4ae9b442f54` — 9 info
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `400` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `404` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `500` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_id` to the response with the `400` status
  - …5 more
- …earlier changes not shown

[Full history](https://skmtc.dev/shipengine/apis/shipengine-api/changes/v1/batches/:batch_id/process/labels/post.md)

---

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