---
title: "getInboundShipmentLabels"
method: GET
path: "/awd/2024-05-09/inboundShipments/{shipmentId}/labels"
tags: ["Amazon Warehousing and Distribution v2024-05-09"]
---

# getInboundShipmentLabels

`GET /awd/2024-05-09/inboundShipments/{shipmentId}/labels`

Retrieves the box labels for a shipment ID that you specify. This is an asynchronous operation. If the label status is `GENERATED`, then the label URL is available.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 1 | 2 |

The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).

## Path parameters

- `shipmentId` string, required

## Query parameters

- `pageType` 'PLAIN_PAPER'
- `formatType` 'PDF'

## Response `200`

The 200 response for `getInboundShipmentLabels`.

- ShipmentLabels — Shipment labels.
  - `labelDownloadURL` string — The URL to download shipment labels. The URL is active for 600 seconds from generation.
  - `labelStatus` 'GENERATING' | 'GENERATED' | 'GENERATION_FAILED' | 'NOT_READY', required — The status of your label.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)