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

# Retrieve a return label

> Download a return label as a PDF

<Warning>
  **API v2 is entering maintenance mode.** New users should start with API v3 to access our latest features and improved performance. Already using v2? Don't worry, your current integration remains fully functional. Read more about [maintenance mode](/docs/getting-started/api-version-guide), or check out the [migration guide for API v3](/docs/getting-started/migration-guidelines-for-api-v3).
</Warning>

Once a return parcel has been successfully created and announced to the carrier, the label will be ready to download. This endpoint returns the return label file (in PDF format).

You should not need to manually construct the URL for this endpoint, as it is returned in the response body for the [Retrieve the status of a return](/api/v2/return-portal/retrieve-the-status-of-a-return) endpoint.


## OpenAPI

````yaml /.openapi/v2/return-portal/openapi.yaml get /brand/{brand_domain}/return-portal/label/download
openapi: 3.1.0
info:
  title: Return portal
  version: 2.0.0
  description: >-
    The Return portal API provides you with the tools to manage your own return
    portal, and create returns through that portal.
  contact:
    name: Sendcloud API Support
    url: https://www.sendcloud.dev
    email: contact@sendcloud.com
  termsOfService: https://www.sendcloud.com/terms-conditions/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://panel.sendcloud.sc/api/v2
    description: Sendcloud Production
security: []
tags:
  - name: Return portal
    description: Sendcloud's Return portal
paths:
  /brand/{brand_domain}/return-portal/label/download:
    parameters:
      - schema:
          type: string
        name: brand_domain
        in: path
        required: true
        description: The domain of the brand configured for your return portal.
    get:
      tags:
        - Return portal
      summary: Retrieve a return label
      description: Download a return label as a PDF
      operationId: sc-public-v2-scp-get-label_download
      parameters:
        - schema:
            type: string
          in: query
          name: token
          description: Token that is used to find the right parcel.
          required: true
      responses:
        '200':
          description: OK
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        '404':
          $ref: '#/components/responses/404'
      security:
        - JWTtoken: []
components:
  responses:
    '404':
      description: Not Found
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: integer
                    example: 404
                  request:
                    type: string
                    example: api/v2/brand/brand_domain/return-portal
                  message:
                    type: string
                    example: No ReturnsPortal matches the given query
  securitySchemes:
    JWTtoken:
      type: http
      scheme: bearer
      description: The JWT generated when starting the Return Portal process

````