Get shipping labels

Learn how to use the Vendor Direct Fulfillment Shipping API to get shipping labels. The getShippingLabels operation returns shipping labels for all orders which meet the filter criteria specified in the request. You must have already requested shipping labels using the submitShippingLabelRequest operation before you use this API to get shipping labels available to you for fulfillment. Amazon recommends that vendors check for shipping labels at least once per hour during business hours. Depending on your business volume, you can choose to check more frequently. You can get up to 100 shipping labels in one API call. If there are more than 100 shipping labels you can use the nextToken value to get the next set of shipping labels.

Shipping labels expire 90 days after their creation date (the submitShippingLabelRequestdate).

📘
Note
This is a restricted operation and requires a Restricted Data Token (RDT) for authorization. For more information, refer to the Tokens API Use Case Guide.

The following diagram shows the integration workflow when retrieving shipping labels:

The Direct Fulfillment integration workflow when retrieving shipping labels.

Prerequisites

To complete this tutorial, you need:

Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API applications.
The Direct-to-Consumer Shipping (Restricted) role assigned to your developer profile.
The Direct-to-Consumer Shipping (Restricted) role selected in the app registration page for your application.