Skip to main content
GET /v5/shipments/documents/labels/ is the documents listing 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. Full specs: API reference.
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.
This endpoint returns download URLs only. When you need the label bytes inline — for direct printing without a second fetch — use Retrieve a Document with the label’s document_uuid, which also returns base64_content.