---
title: "Created Combined Label Document"
method: POST
path: "/v1/documents/combined_labels"
tags: ["labels"]
---

# Created Combined Label Document

`POST /v1/documents/combined_labels`

Download a combined label file

## Request body

- CreateCombinedLabelDocumentRequestBody — A create combined label document request body
  - `label_ids` SeId[] — The list of up to 30 label ids to include in the combined label document. Note that to avoid response size limits, you should only expect to be able to combine 30 single page labels similar in size to that of USPS labels.
  - `label_format` 'pdf' — The file format for the combined label document; note that currently only `"pdf"` is supported.
  - `label_download_type` 'url' | 'inline' — There are two different ways to [download a label](https://www.shipengine.com/docs/labels/downloading/): |Label Download Type | Description |--------------------|------------------------------ |`url` |You will receive a URL, which you can use to download the label in a separate request. The URL will remain valid for 90 days. |`inline` |You will receive the Base64-encoded label as part of the response. No need for a second request to download the label.

## Response `200`

The requested object creation was a success.

- CreateCombinedLabelDocumentResponseBodyYaml — A create combined label document response body
  - `label_download` LabelDownload — Reference to the various downloadable file formats for the generated label
    - `href` string, url — A URL
    - `pdf` string, url — A URL
    - `png` string, url — A URL
    - `zpl` string, url — A URL

## 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.

---

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