Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
The following datatypes are used in the response elements of the Amazon Marketplace Web Service (Amazon MWS) Products API section:
Datatype | Description |
---|---|
AvailabilityType | Indicates whether the item is available for shipping now, or on a known or an unknown date in the future. |
BuyBoxPrice | The price of an item that is displayed in the Buy Box. |
DetailedShippingTimeType | The maximum time within which the item will likely be shipped once an order has been placed. |
FeeDetail | The type of fee, fee amount, and other details. |
FeesEstimate | The total estimated fees for a product and a list of details. |
FeesEstimateIdentifier | A product identifier, marketplace, time of request, and other details that identify an estimate. |
FeesEstimateRequest | A product, marketplace, and proposed price used to request estimated fees. |
FeesEstimateResult | A product identifier and the estimated fees for that product. |
FeeType | The type of fee charged to a seller. |
FulfillmentChannelType | Indicates whether the item is fulfilled by Amazon or by the seller. |
LowestPrice | The lowest price of an item. |
MarketplaceType | An encrypted, Amazon-defined marketplace identifier. |
MoneyType | An amount of money in a specified currency. |
OfferCount | The number of offers in a fulfillment channel that meet a specific condition. |
OfferCountType | The total number of offers for the specified condition and fulfillment channel. |
Points | The number of Amazon Points offered with the purchase of an item. |
PriceToEstimateFees | Price information for a product, used to estimate fees. |
PrimeInformation | Amazon Prime information. |
SalesRank | The sales rank of the item in the given product category. |
SellerFeedbackRating | Information about the seller's feedback, including the percentage of positive feedback, and the total count of feedback received. |
ShipsFrom | The state and country from where the item is shipped. |
Indicates whether the item is available for shipping now, or on a known or an unknown date in the future.
Type: xs:string
Values:
The price of an item that is displayed in the Buy Box.
Name | Description | Required | Values |
---|---|---|---|
condition | Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club. | Yes | Type: xs:string |
The time range in which an item will likely be shipped once an order has been placed.
Name | Description | Required | Values |
---|---|---|---|
minimumHours | The minimum time, in hours, that the item will likely be shipped after the order has been placed. | No | Type: xs:short |
maximumHours | The maximum time, in hours, that the item will likely be shipped after the order has been placed. | No | Type: xs:short |
availableDate | The date when the item will be available for shipping. Only displayed for items that are not currently available for shipping. | No |
ISO 8601 date time format
Type: xs:dateTime |
availabilityType | Indicates whether the item is available for shipping now, or on a known or an unknown date in the future. If known, the availableDate attribute indicates the date that the item will be available for shipping. | No | Type: AvailabilityType |
The type of fee, fee amount, and other details.
For more information on fees, see Selling on Amazon Fee Schedule and FBA features and fees on Seller Central.
Name | Description | Required | Values |
---|---|---|---|
FeeType | The type of fee charged to a seller. | Yes | Type: FeeType |
FeeAmount | The amount charged for a given fee. | Yes | Type: MoneyType |
FeePromotion | The promotion amount for a given fee. | No | Type: MoneyType |
TaxAmount | The tax amount for a given fee. This is only shown for the India marketplace. | No | Type: MoneyType |
FinalFee | The final fee amount for a given fee. | Yes | Type: MoneyType |
IncludedFeeDetailList | A list of other fees that contributes to a given fee. | No | Type: List of FeeDetail |
The total estimated fees for a product and a list of details.
Name | Description | Required | Values |
---|---|---|---|
TimeOfFeesEstimation | The time for which the fees were estimated. This defaults to the time the request is made. | Yes | Type: xs:dateTime |
TotalFeesEstimate | Total estimated fees for a given product, price, and fulfillment channel. | Yes | Type: MoneyType |
FeeDetailList | A list of other fees that contributes to a given fee. | Yes | Type: List of FeeDetail |
A product identifier, marketplace, time of request, and other details that identify an estimate.
Name | Description | Required | Values |
---|---|---|---|
MarketplaceId | An encrypted, Amazon-defined marketplace identifier. | Yes | Type: MarketplaceType |
IdType | The type of product identifier used by IdValue. | Yes | IdType values: ASIN,
SellerSKU
Type: xs:string |
IdValue | The product identifier. | Yes | Type: xs:string |
PriceToEstimateFees | The product price that the fee estimate is based on. | Yes | Type: PriceToEstimateFees |
IsAmazonFulfilled | true if the offer is fulfilled by Amazon. | Yes | Type: xs:boolean |
SellerInputIdentifier | A unique identifier provided by the caller to track this request. | Yes | Type: xs:string |
A product, marketplace, and proposed price used to request estimated fees.
Name | Description | Required | Values |
---|---|---|---|
MarketplaceId | An encrypted, Amazon-defined marketplace identifier. | Yes | Type: MarketplaceType |
IdType | The type of product identifier used by IdValue. | Yes | IdType values: ASIN,
SellerSKU
Type: xs:string |
IdValue | The product identifier. | Yes | Type: xs:string |
PriceToEstimateFees | The product price that the fee estimate is based on. | Yes | Type: PriceToEstimateFees |
Identifier | A unique value that will identify this request. | Yes | Type: xs:string |
IsAmazonFulfilled | true if the offer is fulfilled by Amazon. | Yes | Type: xs:boolean |
A product identifier and the estimated fees for that product.
Name | Description | Required | Values |
---|---|---|---|
FeesEstimateIdentifier | Information used to identify a product fee request. | Yes | Type: FeesEstimateIdentifier |
FeesEstimate | The total estimated fees for a product and a list of details. | No | Type: FeesEstimate |
Status | The status of the fee request. | Yes | Status values:
Success, ClientError,
ServiceError Type: xs:string |
Error | An Error object with a Type, Code, and Message. | No | Type: Error |
For information on handling the Status or Error elements, see Processing bulk operation requests.
The type of fee charged to a seller.
Type: xs:string
Values:
Indicates whether the item is fulfilled by Amazon or by the seller.
Type: xs:string
Values:
The lowest price of an item.
Name | Description | Required | Values |
---|---|---|---|
condition | Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club. | Yes | Type: xs:string |
fulfillmentChannel | Indicates whether the item is fulfilled by Amazon or by the seller. | Yes | Type: FulfillmentChannelType |
An encrypted, Amazon-defined marketplace identifier.
Type: xs:string
Restriction: [A-Z0-9]+
For a list of MarketplaceId values, see Amazon MWS endpoints and MarketplaceId values in the Amazon MWS Developer Guide.
An amount of money in a specified currency.
Name | Description | Required | Values |
---|---|---|---|
Amount | The currency amount. | Yes | Type: xs:decimal |
CurrencyCode | Three-digit currency code. | Yes | In
ISO 4217 format
. Type: xs:string |
The number of offers in a fulfillment channel that meet a specific condition.
Name | Description | Required | Values |
---|---|---|---|
condition | Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club. | Yes | Type: xs:string |
fulfillmentChannel | Indicates whether the item is fulfilled by Amazon or by the seller. | Yes | Type: FulfillmentChannelType |
The OfferCount element does not contain any child elements. It is an extension of Type: xs:int.
The total number of offers for the specified condition and fulfillment channel.
Name | Description | Required | Values |
---|---|---|---|
OfferCount | The number of offers in a fulfillment channel that meet a specific condition. | No | Type: OfferCount |
The number of Amazon Points offered with the purchase of an item. The Amazon Points program is only available in Japan.
Name | Description | Required | Values |
---|---|---|---|
PointsNumber | The number of Amazon Points. | Yes | Type: xs:int |
PointsMonetaryValue | The monetary value of the points. | Yes | Type: MoneyType |
Price information for a product, used to estimate fees.
Amazon Prime information.
Name | Description |
---|---|
IsNationalPrime | Indicates whether the offer is an Amazon Prime offer throughout the entire
marketplace where it is listed. Required. Type: xs:boolean |
IsPrime | Indicates whether the offer is an Amazon Prime offer. Required. Type: xs:boolean |
The sales rank of the item in the given product category.
Name | Description |
---|---|
ProductCategoryId | The product category identifier of the
item. Required. Type: xs:string |
Rank | The sales rank of the item in the given product
category. Required. Type: xs:int |
Information about the seller's feedback, including the percentage of positive feedback, and the total count of feedback received.
Name | Description | Required | Values |
---|---|---|---|
SellerPositiveFeedbackRating | The percentage of positive feedback for the seller in the past 365 days. | No | Type: xs:double |
FeedbackCount | The count of feedback received about the seller. | Yes | Type: xs:long |
The state and country from where the item is shipped.
Name | Description | Required | Values |
---|---|---|---|
State | The state from where the item is shipped. | No | Type: xs:string |
Country | The country from where the item is shipped. | No | Type: xs:string |