1P pure Off-Amazon

This document provides a summary of the overall process and the specific steps to 1) Register for a developer account, 2) Obtaining your API credentials, and 3) Accessing the Shipping APIs.

Amazon Shipping API Integration Guide

This guide provides an overview of the process of integrating with the Amazon Shipping APIs. Please note this documentation is applicable to shippers who are not selling on the Amazon Marketplace. If you sell on Amazon, please contact your account manager for guidance on the appropriate procedure.

After you complete the steps listed in this guide, you will be able to submit a Seller Partner application which provides the credentials to access the Amazon Shipping APIs.


Below these steps to create a Seller Partner application to receive your API credentials to call the Amazon Shipping APIs.

Step 1: Register an Amazon Shipping RIVER account
This step will allow you access to RIVER, the communications platform you will use to contact our support team if you need help with any of the below steps.

  1. To get started, your account manager will invite the relevant point of contact in your organization to create an account on RIVER. Please accept the invite and create an account.

Step 2: Registering as a Developer
Through this step you will request access to the Amazon Logistics role from your Amazon account. This is a prerequisite to accessing the Amazon Shipping API.

  1. If you do not already have an Amazon account, please create one. (Note: You are not required to create a Seller account to call the Shipping APIs). Below represents one way to create an account:
  • Please visit amazon.com and click on ‘Start here’
  • Enter all the requested information and click ‘Continue’.
  • Once you have created the account, please proceed to the next step.
  1. Visit the page that applies to you. Use the credentials you created in the previous step to log in.
  2. After logging in, you will notice the URL in the address bar will change to:
  3. Please send back the DirectedId cited in the updated URL to us via RIVER so we can create a Developer Central account for you.
  4. Once a Developer Central account has been created, you will receive an email confirmation. Then proceed to log in and register as a developer.

In your developer registration, you will provide details about your organization and create an application to Amazon. The details collected will be used to vet and approve your permissions, allowing access to data via our APIs.

  1. Click Proceed to Developer Profile button. Otherwise click the Your Developer Profile link.
  2. Complete the form.
  3. Ensure you provide accurate contact details for future communications.
  1. For the Data Access question (screenshot below), select the option that reads “My organization participates in Amazon services, and I want to integrate to manage my own business only”
  1. For the Roles question (screenshot below), select “Amazon Logistics” to request access to the Amazon Shipping APIs.

You will now go through the data protection requirements questionnaire under Security Controls. These responses will be reviewed by a team that assess your security posture. Amazon holds a high bar for data protection and to ensure there is no delay to your application we recommend you respond as thoroughly as possible. Please reach out to your account manager if you have questions.

  1. For the Security Controls questions (screenshot below), select the appropriate responses and provide details of the mechanisms you have in place. If you are unsure of responses to questions requiring information handled by third-party developers, please validate your responses with your third-party developers and receive any necessary assistance from them before filling out the form.
  1. After you have entered all the information and clicked on Register, your Developer Profile form will be submitted. Please provide the case number generated by Developer Central to us via your RIVER support case so we can expedite the process for you.
  2. You will receive a response from Amazon (either accept or reject) in 5 business days. If your developer profile is approved but you do not have access to the Amazon Logistics Shipping role, then please write back on the RIVER support case to have this rectified.

Please note: If your registration is rejected, you are required to resubmit the form. Please include additional or corrected information that may have been missing in your previous submissions. In such instance, it is likely access to the Amazon Logistics Shipping role may take longer than 5 days.

Step 3: Creating your Shipper App
This step will establish a Selling Partner application that will provide you the API credentials to call Amazon Shipping APIs.

  1. Create an AWS account, accept the IAM policy, and create IAM user as noted in the Creating and configuring IAM policies and entities section of the Selling Partner API Developer Guide.
  2. API Type - choose “SP-API” type for SP-API apps, “Shipping” as Business entity, and “Amazon Logistics” as Shipping role.

Note: If you are registering an application, a Freight/Shipping check box appears after you choose the SP-API type. Choose Shipping for your Shipping use case.

Select No when asked “The Restricted Data Token (RDT) enables developers to securely delegate access to Personally Identifiable Information (PII) to another developer's application. Will you delegate access to PII to another developer's application?”

  1. Once the app is created, review the app in the Developer Central.
  2. Get your refresh token - Refer to the Self Authorization section of the Selling Partner API Developer Guide to understand how to provision the API credentials for the Amazon Shipping APIs.

Step 4: Integrate with the Amazon Shipping APIs
This step details the process of integrating with Amazon Shipping APIs. At this point, you should have access to your SPDS application and your API credentials to make calls to the Amazon Shipping APIs.

  1. Please review the Amazon Shipping API user guide and Swagger model for details on the API operations and behavior.
  2. Develop your integration. If there is any support required, please reach out to your Account manager to get the right support to solve. We recommend that you support these use cases at the minimum:
    • Functionality to get rates via the Shipping APIs.
    • Functionality to purchase shipment via the Shipping APIs.
    • Functionality to cancel shipment via the Shipping APIs.
    • Functionality to track shipment via the Shipping APIs.
  3. Produce a test label and follow the steps on the Amazon Shipping Test Label Guide for sign off.
  4. Once signed off, your Account Manager will work with you to confirm your first shipping date.

Did this page help you?