---
title: "Return a single PDF file with generated label and/or associated document(s)"
method: GET
path: "/orders/{orderIdentifiers}/label"
tags: ["Labels"]
---

# Return a single PDF file with generated label and/or associated document(s)

`GET /orders/{orderIdentifiers}/label`

<b>Reserved for OBA customers only</b>

The account "Label format" settings page will control the page format settings used to print the postage label
and associated documents. Certain combinations of these settings may prevent associated documents from being
printed together with the postage label within a single document. If this occurs the documentType option can be
used in a separate call to print missing documents.

## Path parameters

- `orderIdentifiers` string, required

## Query parameters

- `documentType` 'postageLabel' | 'despatchNote' | 'CN22' | 'CN23', required
- `includeReturnsLabel` boolean
- `includeCN` boolean

## Response `200`

Return the PDF file with labels

- string, binary

## Other responses

- `400` — Bad Request (Request has missing or invalid parameters and cannot be parsed)
- `401` — Unauthorized
- `403` — Forbidden (Feature available for OBA accounts only)
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/royalmail/apis/channelshipper-royal-mail-public-api.md) · [All operations](https://skmtc.net/royalmail/apis/channelshipper-royal-mail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/royalmail/channelshipper-royal-mail-public-api/revisions/7e0c23c81719/schema)