---
title: "Gets the label for the specified courier parcel barcode and order awb"
method: GET
path: "/api/Label/by-courier/{courierId}/awb/{awb}/parcel/{barcodes}"
tags: ["Label"]
---

# Gets the label for the specified courier parcel barcode and order awb

`GET /api/Label/by-courier/{courierId}/awb/{awb}/parcel/{barcodes}`

## Request

- Base URL: `https://api.innoship.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.innoship.io/api/Label/by-courier/{courierId}/awb/{awb}/parcel/{barcodes}`
- Auth: API key in header `X-Api-Key`

## Path parameters

- `courierId` integer, required
- `awb` string, required
- `barcodes` string, required

## Query parameters

- `type` string
- `format` string
- `orientation` string
- `useFile` boolean
- `skipCache` boolean
- `noReprint` boolean
- `api-version` string, required

## Headers

- `api-version` string

## Response `200`

Returns the label

- InnoshipApiServiceContractLabelLabelResponse
  - `courier` integer
  - `contents` string, nullable
  - `labels` string[], nullable

## Other responses

- `400`: Unable to get the label due to validation errors
- `401`: Unable to authorize request

## Changes

- **2026-10-06** `adac0ee66cab`: 6 info
  - added the optional property `errors/items/categoryCode` to the response with the `400` status (media type: application/pdf)
  - added the optional property `errors/items/categoryCode` to the response with the `400` status (media type: application/json)
  - added the optional property `errors/items/categoryCode` to the response with the `400` status (media type: text/html)
  - added the optional property `errors/items/subcategoryCode` to the response with the `400` status (media type: application/pdf)
  - …2 more

[Operation history](https://skmtc.dev/innoship/apis/innoship-api/changes/api/Label/by-courier/:courierId/awb/:awb/parcel/:barcodes/get.md)

---

[API](https://skmtc.dev/innoship/apis/innoship-api.md) - [All operations](https://skmtc.dev/innoship/apis/innoship-api/llms.txt) - [OpenAPI document](https://skmtc.dev/innoship/apis/innoship-api/revisions/99970aa2068d?raw)