> ## Documentation Index
> Fetch the complete documentation index at: https://developers.perform.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve shipping labels

> Fetch the shipping labels of up to ten Shipments in one call.

`GET /v5/shipments/documents/labels/` is the [documents listing](/guides/shipment-documents) pre-filtered to shipping labels — documents whose `type` is `shipping_label` (formats such as PDF, ZPL, PNG) or `shipping_label_qr` (PNG, JPG, PDF). Labels are created by [Create Booking](/guides/create-booking). Full specs: [API reference](/api-reference/v5/documents/list-labels).

```bash theme={null}
curl --request GET \
  --url 'https://api.perform.ai/v5/shipments/documents/labels/?shipment_ids=SHP-2026-000115,SHP-2026-000116' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

The rules mirror the documents listing:

* Identify Shipments with **either** `shipment_uuids` **or** `shipment_ids` — never both — comma-joined without spaces, up to **10** per request.
* Page-based pagination: `limit` 25–100 (default 25), `page` from 1, `total_pages` in the response.
* **Every `download_url` expires after 1 hour** and is regenerated per call — store `document_uuid`, not the URL.
* No matching labels returns HTTP 200 with an empty `data` array.

Each label carries its Shipment context (`shipment_uuid`, `shipment_id`, `tracking_number`), document identifiers, `type`, `file_format`, `created_date`, and `additional_info` — check the latter for label size (A6, 4x6) or ZPL dialect before printing.

<Note>
  This endpoint returns download URLs only. When you need the label bytes inline — for direct printing without a second fetch — use [Retrieve a Document](/guides/shipment-documents) with the label's `document_uuid`, which also returns `base64_content`.
</Note>