Shipping API v1 Reference
Provides programmatic access to Amazon Shipping APIs.
Overview
Provides programmatic access to Amazon Shipping APIs.
Note: If you are new to the Amazon Shipping API, refer to the latest version of Amazon Shipping API (v2) on the Amazon Shipping Developer Documentation site.
Version information
Version : v1
Contact information
Contact : Selling Partner API Developer Support
Contact URL : https://sellercentral.amazon.com/gp/mws/contactus.html
License information
License : Apache License 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0
URI scheme
Host : sellingpartnerapi-na.amazon.com
Schemes : HTTPS
Consumes
application/json
Produces
application/json
Operations
createShipment
getShipment
cancelShipment
purchaseLabels
retrieveShippingLabel
purchaseShipment
getRates
getAccount
getTrackingInformation
Paths
POST /shipping/v1/shipments
Operation: createShipment
Description
Create a new shipment.
Usage Plan:
Rate (requests per second) | Burst |
---|---|
5 | 15 |
The x-amzn-RateLimit-Limit
response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Body | body required | The request schema for the createShipment operation. | CreateShipmentRequest |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | CreateShipmentResponse |
400 | Request has missing or invalid parameters and cannot be parsed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | CreateShipmentResponse |
401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | CreateShipmentResponse |
403 | 403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. Headers : x-amzn-RequestId (string) : Unique request reference id. | CreateShipmentResponse |
404 | The resource specified does not exist. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | CreateShipmentResponse |
429 | The frequency of requests was greater than allowed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | CreateShipmentResponse |
500 | Encountered an unexpected condition which prevented the server from fulfilling the request. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | CreateShipmentResponse |
503 | Temporary overloading or maintenance of the server. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | CreateShipmentResponse |
GET /shipping/v1/shipments/{shipmentId}
Operation: getShipment
Description
Return the entire shipment object for the shipmentId.
Usage Plan:
Rate (requests per second) | Burst |
---|---|
5 | 15 |
For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
Parameters
Type | Name | Schema |
---|---|---|
Path | shipmentId required | string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetShipmentResponse |
400 | Request has missing or invalid parameters and cannot be parsed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetShipmentResponse |
401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetShipmentResponse |
403 | 403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. Headers : x-amzn-RequestId (string) : Unique request reference id. | GetShipmentResponse |
404 | The resource specified does not exist. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetShipmentResponse |
429 | The frequency of requests was greater than allowed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetShipmentResponse |
500 | Encountered an unexpected condition which prevented the server from fulfilling the request. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetShipmentResponse |
503 | Temporary overloading or maintenance of the server. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetShipmentResponse |
POST /shipping/v1/shipments/{shipmentId}/cancel
Operation: cancelShipment
Description
Cancel a shipment by the given shipmentId.
Usage Plan:
Rate (requests per second) | Burst |
---|---|
5 | 15 |
For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
Parameters
Type | Name | Schema |
---|---|---|
Path | shipmentId required | string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | CancelShipmentResponse |
400 | Request has missing or invalid parameters and cannot be parsed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | CancelShipmentResponse |
401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | CancelShipmentResponse |
403 | 403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. Headers : x-amzn-RequestId (string) : Unique request reference id. | CancelShipmentResponse |
404 | The resource specified does not exist. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | CancelShipmentResponse |
429 | The frequency of requests was greater than allowed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | CancelShipmentResponse |
500 | Encountered an unexpected condition which prevented the server from fulfilling the request. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | CancelShipmentResponse |
503 | Temporary overloading or maintenance of the server. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | CancelShipmentResponse |
POST /shipping/v1/shipments/{shipmentId}/purchaseLabels
Operation: purchaseLabels
Description
Purchase shipping labels based on a given rate.
Usage Plan:
Rate (requests per second) | Burst |
---|---|
5 | 15 |
For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path | shipmentId required | - | string |
Body | body required | The request schema for the purchaseLabels operation. | PurchaseLabelsRequest |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | PurchaseLabelsResponse |
400 | Request has missing or invalid parameters and cannot be parsed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | PurchaseLabelsResponse |
401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | PurchaseLabelsResponse |
403 | 403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. Headers : x-amzn-RequestId (string) : Unique request reference id. | PurchaseLabelsResponse |
404 | The resource specified does not exist. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | PurchaseLabelsResponse |
429 | The frequency of requests was greater than allowed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | PurchaseLabelsResponse |
500 | Encountered an unexpected condition which prevented the server from fulfilling the request. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | PurchaseLabelsResponse |
503 | Temporary overloading or maintenance of the server. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | PurchaseLabelsResponse |
POST /shipping/v1/shipments/{shipmentId}/containers/{trackingId}/label
Operation: retrieveShippingLabel
Description
Retrieve shipping label based on the shipment id and tracking id.
Usage Plan:
Rate (requests per second) | Burst |
---|---|
5 | 15 |
For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path | shipmentId required | - | string |
Path | trackingId required | - | string |
Body | body required | The request schema for the retrieveShippingLabel operation. | RetrieveShippingLabelRequest |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | RetrieveShippingLabelResponse |
400 | Request has missing or invalid parameters and cannot be parsed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | RetrieveShippingLabelResponse |
401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | RetrieveShippingLabelResponse |
403 | 403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. Headers : x-amzn-RequestId (string) : Unique request reference id. | RetrieveShippingLabelResponse |
404 | The resource specified does not exist. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | RetrieveShippingLabelResponse |
429 | The frequency of requests was greater than allowed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | RetrieveShippingLabelResponse |
500 | Encountered an unexpected condition which prevented the server from fulfilling the request. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | RetrieveShippingLabelResponse |
503 | Temporary overloading or maintenance of the server. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | RetrieveShippingLabelResponse |
POST /shipping/v1/purchaseShipment
Operation: purchaseShipment
Description
Purchase shipping labels.
Usage Plan:
Rate (requests per second) | Burst |
---|---|
5 | 15 |
For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Body | body required | The payload schema for the purchaseShipment operation. | PurchaseShipmentRequest |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | PurchaseShipmentResponse |
400 | Request has missing or invalid parameters and cannot be parsed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | PurchaseShipmentResponse |
401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | PurchaseShipmentResponse |
403 | 403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. Headers : x-amzn-RequestId (string) : Unique request reference id. | PurchaseShipmentResponse |
404 | The resource specified does not exist. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | PurchaseShipmentResponse |
429 | The frequency of requests was greater than allowed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | PurchaseShipmentResponse |
500 | Encountered an unexpected condition which prevented the server from fulfilling the request. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | PurchaseShipmentResponse |
503 | Temporary overloading or maintenance of the server. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | PurchaseShipmentResponse |
POST /shipping/v1/rates
Operation: getRates
Description
Get service rates.
Usage Plan:
Rate (requests per second) | Burst |
---|---|
5 | 15 |
For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Body | body required | The payload schema for the getRates operation. | GetRatesRequest |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetRatesResponse |
400 | Request is missing or has invalid parameters and cannot be parsed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetRatesResponse |
401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetRatesResponse |
403 | 403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. Headers : x-amzn-RequestId (string) : Unique request reference id. | GetRatesResponse |
404 | The resource specified does not exist. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetRatesResponse |
429 | The frequency of requests was greater than allowed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetRatesResponse |
500 | Encountered an unexpected condition which prevented the server from fulfilling the request. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetRatesResponse |
503 | Temporary overloading or maintenance of the server. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetRatesResponse |
GET /shipping/v1/account
Operation: getAccount
Description
Verify if the current account is valid.
Usage Plan:
Rate (requests per second) | Burst |
---|---|
5 | 15 |
For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | The account was valid. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetAccountResponse |
400 | Request has missing or invalid parameters and cannot be parsed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetAccountResponse |
401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetAccountResponse |
403 | 403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. Headers : x-amzn-RequestId (string) : Unique request reference id. | GetAccountResponse |
404 | The resource specified does not exist. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetAccountResponse |
429 | The frequency of requests was greater than allowed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetAccountResponse |
500 | Encountered an unexpected condition which prevented the server from fulfilling the request. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetAccountResponse |
503 | Temporary overloading or maintenance of the server. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetAccountResponse |
GET /shipping/v1/tracking/{trackingId}
Operation: getTrackingInformation
Description
Return the tracking information of a shipment.
Usage Plan:
Rate (requests per second) | Burst |
---|---|
1 | 1 |
For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
Parameters
Type | Name | Schema |
---|---|---|
Path | trackingId required | string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetTrackingInformationResponse |
400 | Request has missing or invalid parameters and cannot be parsed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetTrackingInformationResponse |
401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetTrackingInformationResponse |
403 | 403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. Headers : x-amzn-RequestId (string) : Unique request reference id. | GetTrackingInformationResponse |
404 | The resource specified does not exist. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference id. | GetTrackingInformationResponse |
429 | The frequency of requests was greater than allowed. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetTrackingInformationResponse |
500 | Encountered an unexpected condition which prevented the server from fulfilling the request. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetTrackingInformationResponse |
503 | Temporary overloading or maintenance of the server. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.Note: For this status code, the rate limit header is deprecated and no longer returned. x-amzn-RequestId (string) : Unique request reference id. | GetTrackingInformationResponse |
Definitions
Error
Error response returned when the request is unsuccessful.
Name | Description | Schema |
---|---|---|
code required | An error code that identifies the type of error that occured. | string |
message required | A message that describes the error condition in a human-readable form. | string |
details optional | Additional details that can help the caller understand or fix the issue. | string |
ErrorList
A list of error responses returned when a request is unsuccessful.
Type : < Error > array
AccountId
This is the Amazon Shipping account id generated during the Amazon Shipping onboarding process.
Type : string
maxLength : 10
ShipmentId
The unique shipment identifier.
Type : string
ClientReferenceId
Client reference id.
Type : string
maxLength : 40
ContainerReferenceId
An identifier for the container. This must be unique within all the containers in the same shipment.
Type : string
maxLength : 40
EventCode
The event code of a shipment, such as Departed, Received, and ReadyForReceive.
Type : string
minLength : 1
maxLength : 60
StateOrRegion
The state or region where the person, business or institution is located.
Type : string
City
The city where the person, business or institution is located.
Type : string
minLength : 1
maxLength : 50
CountryCode
The two digit country code. In ISO 3166-1 alpha-2 format.
Type : string
minLength : 2
maxLength : 2
PostalCode
The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation.
Type : string
minLength : 1
maxLength : 20
Location
The location where the person, business or institution is located.
Name | Description | Schema |
---|---|---|
stateOrRegion optional | The state or region where the person, business or institution is located. | StateOrRegion |
city optional | The city where the person, business or institution is located. | City |
countryCode optional | The two digit country code. In ISO 3166-1 alpha-2 format. | CountryCode |
postalCode optional | The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation. | PostalCode |
Event
An event of a shipment
EventList
A list of events of a shipment.
Type : < Event > array
TrackingId
The tracking id generated to each shipment. It contains a series of letters or digits or both.
Type : string
minLength : 1
maxLength : 60
TrackingSummary
The tracking summary.
Name | Description | Schema |
---|---|---|
status optional | The derived status based on the events in the eventHistory. minLength : 1 maxLength : 60 | string |
PromisedDeliveryDate
The promised delivery date and time of a shipment.
Type : string (date-time)
Address
The address.
Name | Description | Schema |
---|---|---|
name required | The name of the person, business or institution at that address. minLength : 1 maxLength : 50 | string |
addressLine1 required | First line of that address. minLength : 1 maxLength : 60 | string |
addressLine2 optional | Additional address information, if required. minLength : 1 maxLength : 60 | string |
addressLine3 optional | Additional address information, if required. minLength : 1 maxLength : 60 | string |
stateOrRegion required | The state or region where the person, business or institution is located. | StateOrRegion |
city required | The city where the person, business or institution is located. | City |
countryCode required | The two digit country code. In ISO 3166-1 alpha-2 format. | CountryCode |
postalCode required | The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation. | PostalCode |
email optional | The email address of the contact associated with the address. maxLength : 64 | string |
copyEmails optional | The email cc addresses of the contact associated with the address. | < string > array |
phoneNumber optional | The phone number of the person, business or institution located at that address. minLength : 1 maxLength : 20 | string |
TimeRange
The time range.
Name | Description | Schema |
---|---|---|
start optional | The start date and time. This defaults to the current date and time. | string (date-time) |
end optional | The end date and time. This must come after the value of start. This defaults to the next business day from the start. | string (date-time) |
ShippingPromiseSet
The promised delivery time and pickup time.
ServiceType
The type of shipping service that will be used for the service offering.
Type : enum
Value | Description |
---|---|
Amazon Shipping Ground | Amazon Shipping Ground. |
Amazon Shipping Standard | Amazon Shipping Standard. |
Amazon Shipping Premium | Amazon Shipping Premium. |
ServiceTypeList
A list of service types that can be used to send the shipment.
Type : < ServiceType > array
Rate
The available rate that can be used to send the shipment
Name | Description | Schema |
---|---|---|
rateId optional | An identifier for the rate. | string |
totalCharge optional | The total charge that will be billed for the rate. | Currency |
billedWeight optional | The weight that was used to calculate the totalCharge. | Weight |
expirationTime optional | The time after which the offering will expire. | string (date-time) |
serviceType optional | The type of shipping service that will be used for the service offering. | ServiceType |
promise optional | The promised delivery time and pickup time. | ShippingPromiseSet |
RateList
A list of all the available rates that can be used to send the shipment.
Type : < Rate > array
RateId
An identifier for the rating.
Type : string
AcceptedRate
The specific rate purchased for the shipment, or null if unpurchased.
Name | Description | Schema |
---|---|---|
totalCharge optional | The total charge that will be billed for the rate. | Currency |
billedWeight optional | The weight that was used to calculate the totalCharge. | Weight |
serviceType optional | The type of shipping service that will be used for the service offering. | ServiceType |
promise optional | The promised delivery time and pickup time. | ShippingPromiseSet |
ServiceRate
The specific rate for a shipping service, or null if no service available.
Name | Description | Schema |
---|---|---|
totalCharge required | The total charge that will be billed for the rate. | Currency |
billableWeight required | The weight that was used to calculate the totalCharge. | Weight |
serviceType required | The type of shipping service that will be used for the service offering. | ServiceType |
promise required | The promised delivery time and pickup time. | ShippingPromiseSet |
ServiceRateList
A list of service rates.
Type : < ServiceRate > array
Party
The account related with the shipment.
Name | Description | Schema |
---|---|---|
accountId optional | This is the Amazon Shipping account id generated during the Amazon Shipping onboarding process. | AccountId |
Currency
The total value of all items in the container.
Name | Description | Schema |
---|---|---|
value required | The amount of currency. | number |
unit required | A 3-character currency code. minLength : 3 maxLength : 3 | string |
Dimensions
A set of measurements for a three-dimensional object.
Name | Description | Schema |
---|---|---|
length required | The length of the container. | number |
width required | The width of the container. | number |
height required | The height of the container. | number |
unit required | The unit of these measurements. | enum (Unit) |
Weight
The weight.
Name | Description | Schema |
---|---|---|
unit required | The unit of measurement. | enum (Unit) |
value required | The measurement value. | number |
ContainerItem
Item in the container.
Name | Description | Schema |
---|---|---|
quantity required | The quantity of the items of this type in the container. | number |
unitPrice required | The unit price of an item of this type (the total value of this item type in the container is unitPrice | Currency |
unitWeight required | The unit weight of an item of this type (the total weight of this item type in the container is unitWeight | Weight |
title required | A descriptive title of the item. maxLength : 30 | string |
Container
Container in the shipment.
Name | Description | Schema |
---|---|---|
containerType optional | The type of physical container being used. (always 'PACKAGE') | enum (ContainerType) |
containerReferenceId required | An identifier for the container. This must be unique within all the containers in the same shipment. | ContainerReferenceId |
value required | The total value of all items in the container. | Currency |
dimensions required | The length, width, height, and weight of the container. | Dimensions |
items required | A list of the items in the container. | < ContainerItem > array |
weight required | The weight of the container. | Weight |
ContainerList
A list of container.
Type : < Container > array
ContainerSpecification
Container specification for checking the service rate.
Name | Description | Schema |
---|---|---|
dimensions required | The length, width, and height of the container. | Dimensions |
weight required | The weight of the container. | Weight |
ContainerSpecificationList
A list of container specifications.
Type : < ContainerSpecification > array
Label
The label details of the container.
Name | Description | Schema |
---|---|---|
labelStream optional | Contains binary image data encoded as a base-64 string. | LabelStream |
labelSpecification optional | The label specification info. | LabelSpecification |
LabelResult
Label details including label stream, format, size.
Name | Description | Schema |
---|---|---|
containerReferenceId optional | An identifier for the container. This must be unique within all the containers in the same shipment. | ContainerReferenceId |
trackingId optional | The tracking identifier assigned to the container. | string |
label optional | The label details of the container. | Label |
LabelResultList
A list of label results
Type : < LabelResult > array
LabelStream
Contains binary image data encoded as a base-64 string.
Type : string
LabelSpecification
The label specification info.
Name | Description | Schema |
---|---|---|
labelFormat required | The format of the label. Enum of PNG only for now. | enum (LabelFormat) |
labelStockSize required | The label stock size specification in length and height. Enum of 4x6 only for now. | enum (LabelStockSize) |
CreateShipmentRequest
The request schema for the createShipment operation.
Name | Description | Schema |
---|---|---|
clientReferenceId required | Client reference id. | ClientReferenceId |
shipTo required | The address. | Address |
shipFrom required | The address. | Address |
containers required | A list of container. | ContainerList |
PurchaseLabelsRequest
The request schema for the purchaseLabels operation.
Name | Description | Schema |
---|---|---|
rateId required | An identifier for the rating. | RateId |
labelSpecification required | The label specification info. | LabelSpecification |
RetrieveShippingLabelRequest
The request schema for the retrieveShippingLabel operation.
Name | Description | Schema |
---|---|---|
labelSpecification required | The label specification info. | LabelSpecification |
GetRatesRequest
The payload schema for the getRates operation.
Name | Description | Schema |
---|---|---|
shipTo required | The address. | Address |
shipFrom required | The address. | Address |
serviceTypes required | A list of service types that can be used to send the shipment. | ServiceTypeList |
shipDate optional | The start date and time. This defaults to the current date and time. | string (date-time) |
containerSpecifications required | A list of container specifications. | ContainerSpecificationList |
PurchaseShipmentRequest
The payload schema for the purchaseShipment operation.
Name | Description | Schema |
---|---|---|
clientReferenceId required | Client reference id. | ClientReferenceId |
shipTo required | The address. | Address |
shipFrom required | The address. | Address |
shipDate optional | The start date and time. This defaults to the current date and time. | string (date-time) |
serviceType required | The type of shipping service that will be used for the service offering. | ServiceType |
containers required | A list of container. | ContainerList |
labelSpecification required | The label specification info. | LabelSpecification |
CreateShipmentResult
The payload schema for the createShipment operation.
Name | Description | Schema |
---|---|---|
shipmentId required | The unique shipment identifier. | ShipmentId |
eligibleRates required | A list of all the available rates that can be used to send the shipment. | RateList |
Shipment
The shipment related data.
Name | Description | Schema |
---|---|---|
shipmentId required | The unique shipment identifier. | ShipmentId |
clientReferenceId required | Client reference id. | ClientReferenceId |
shipFrom required | The address. | Address |
shipTo required | The address. | Address |
acceptedRate optional | The specific rate purchased for the shipment, or null if unpurchased. | AcceptedRate |
shipper optional | The account related with the shipment. | Party |
containers required | A list of container. | ContainerList |
PurchaseLabelsResult
The payload schema for the purchaseLabels operation.
Name | Description | Schema |
---|---|---|
shipmentId required | The unique shipment identifier. | ShipmentId |
clientReferenceId optional | Client reference id. | ClientReferenceId |
acceptedRate required | The specific rate purchased for the shipment, or null if unpurchased. | AcceptedRate |
labelResults required | A list of label results | LabelResultList |
RetrieveShippingLabelResult
The payload schema for the retrieveShippingLabel operation.
Name | Description | Schema |
---|---|---|
labelStream required | Contains binary image data encoded as a base-64 string. | LabelStream |
labelSpecification required | The label specification info. | LabelSpecification |
Account
The account related data.
Name | Description | Schema |
---|---|---|
accountId required | This is the Amazon Shipping account id generated during the Amazon Shipping onboarding process. | AccountId |
GetRatesResult
The payload schema for the getRates operation.
Name | Description | Schema |
---|---|---|
serviceRates required | A list of service rates. | ServiceRateList |
PurchaseShipmentResult
The payload schema for the purchaseShipment operation.
Name | Description | Schema |
---|---|---|
shipmentId required | The unique shipment identifier. | ShipmentId |
serviceRate required | The specific rate for a shipping service, or null if no service available. | ServiceRate |
labelResults required | A list of label results | LabelResultList |
TrackingInformation
The payload schema for the getTrackingInformation operation.
Name | Description | Schema |
---|---|---|
trackingId required | The tracking id generated to each shipment. It contains a series of letters or digits or both. | TrackingId |
summary required | The tracking summary. | TrackingSummary |
promisedDeliveryDate required | The promised delivery date and time of a shipment. | PromisedDeliveryDate |
eventHistory required | A list of events of a shipment. | EventList |
CreateShipmentResponse
The response schema for the createShipment operation.
Name | Description | Schema |
---|---|---|
payload optional | The payload for createShipment operation | CreateShipmentResult |
errors optional | Encountered errors for the operation. | ErrorList |
GetShipmentResponse
The response schema for the getShipment operation.
GetRatesResponse
The response schema for the getRates operation.
Name | Description | Schema |
---|---|---|
payload optional | The payload for getRates operation | GetRatesResult |
errors optional | Encountered errors for the operation. | ErrorList |
PurchaseShipmentResponse
The response schema for the purchaseShipment operation.
Name | Description | Schema |
---|---|---|
payload optional | The payload for purchaseShipment operation | PurchaseShipmentResult |
errors optional | Encountered errors for the operation. | ErrorList |
CancelShipmentResponse
The response schema for the cancelShipment operation.
Name | Description | Schema |
---|---|---|
errors optional | Encountered errors for the operation. | ErrorList |
PurchaseLabelsResponse
The response schema for the purchaseLabels operation.
Name | Description | Schema |
---|---|---|
payload optional | The payload for purchaseLabels operation | PurchaseLabelsResult |
errors optional | Encountered errors for the operation. | ErrorList |
RetrieveShippingLabelResponse
The response schema for the retrieveShippingLabel operation.
Name | Description | Schema |
---|---|---|
payload optional | The payload for retrieveShippingLabel operation | RetrieveShippingLabelResult |
errors optional | Encountered errors for the operation. | ErrorList |
GetAccountResponse
The response schema for the getAccount operation.
GetTrackingInformationResponse
The response schema for the getTrackingInformation operation.
Name | Description | Schema |
---|---|---|
payload optional | The payload for getTrackingInformation operation | TrackingInformation |
errors optional | Encountered errors for the operation. | ErrorList |
LabelFormat
The format of the label. Enum of PNG only for now.
Type : enum
Value | Description |
---|---|
PNG | PNG |
ContainerType
The type of physical container being used. (always 'PACKAGE')
Type : enum
Value | Description |
---|---|
PACKAGE | PACKAGE |
LabelStockSize
The label stock size specification in length and height. Enum of 4x6 only for now.
Type : enum
Value | Description |
---|---|
4x6 | 4x6 |
Unit
Type : enum
For use with the definition(s): Weight
The unit of measurement.
Value | Description |
---|---|
g | Grams |
kg | Kilograms |
oz | Ounces |
lb | Pounds |
For use with the definition(s): Dimensions
The unit of these measurements.
Value | Description |
---|---|
IN | Inches |
CM | Centimeters |
Updated 4 months ago