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

# Gets the label for the specified courier awb number

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

## 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}`
- Auth: API key in header `X-Api-Key`

## Path parameters

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

## Query parameters

- `type` string
- `format` string
- `orientation` string
- `includeVoucher` boolean
- `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/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)