Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

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.

Amazon MWS Documentation

Products Datatypes

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.

AvailabilityType

Indicates whether the item is available for shipping now, or on a known or an unknown date in the future.

Type: xs:string

Values:

  • NOW - The item is available for shipping now.
  • FUTURE_WITHOUT_DATE - The item will be available for shipping on an unknown date in the future.
  • FUTURE_WITH_DATE - The item will be available for shipping on a known date in the future.

BuyBoxPrice

The price of an item that is displayed in the Buy Box.

BuyBoxPrice Attributes

Name Description Required Values
condition Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club. Yes Type: xs:string

BuyBoxPrice Elements

Name Description Required Values
LandedPrice ListingPrice + Shipping - Points Yes Type: MoneyType
ListingPrice The price of the item. Yes Type: MoneyType
Shipping The shipping cost. Yes Type: MoneyType
Points The number of Amazon Points offered with the purchase of an item. No Type: Points

DetailedShippingTimeType

The time range in which an item will likely be shipped once an order has been placed.

DetailedShippingTimeType Attributes

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

FeeDetail

The type of fee, fee amount, and other details.

FeeDetail Elements

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

FeesEstimate

The total estimated fees for a product and a list of details.

FeesEstimate Elements

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

FeesEstimateIdentifier

A product identifier, marketplace, time of request, and other details that identify an estimate.

FeesEstimateIdentifier Elements

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

FeesEstimateRequest

A product, marketplace, and proposed price used to request estimated fees.

FeesEstimateRequest Elements

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

FeesEstimateResult

A product identifier and the estimated fees for that product.

FeesEstimateResult Elements

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.

FeeType

The type of fee charged to a seller.

Type: xs:string

Values:

  • ReferralFee
  • VariableClosingFee
  • PerItemFee
  • FBAFees
  • FBAPickAndPack
  • FBAWeightHandling
  • FBAOrderHandling
  • FBADeliveryServicesFee

FulfillmentChannelType

Indicates whether the item is fulfilled by Amazon or by the seller.

Type: xs:string

Values:

  • Amazon
  • Merchant

LowestPrice

The lowest price of an item.

LowestPrice Attributes

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

LowestPrice Elements

Name Description Required Values
LandedPrice ListingPrice + Shipping - Points Yes Type: MoneyType
ListingPrice The price of the item. Yes Type: MoneyType
Shipping The shipping cost. Yes Type: MoneyType
Points The number of Amazon Points offered with the purchase of an item. No Type: Points

MarketplaceType

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.

MoneyType

An amount of money in a specified currency.

MoneyType Elements

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

OfferCount

The number of offers in a fulfillment channel that meet a specific condition.

OfferCount Attributes

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

OfferCount Elements

The OfferCount element does not contain any child elements. It is an extension of Type: xs:int.

OfferCountType

The total number of offers for the specified condition and fulfillment channel.

OfferCountType Elements

Name Description Required Values
OfferCount The number of offers in a fulfillment channel that meet a specific condition. No Type: OfferCount

Points

The number of Amazon Points offered with the purchase of an item. The Amazon Points program is only available in Japan.

Points Elements

Name Description Required Values
PointsNumber The number of Amazon Points. Yes Type: xs:int
PointsMonetaryValue The monetary value of the points. Yes Type: MoneyType

PriceToEstimateFees

Price information for a product, used to estimate fees.

PriceToEstimateFees Elements

Name Description Required Values
ListingPrice The price of the item. Yes Type: MoneyType
Shipping The shipping cost. No Type: MoneyType
Points The number of Amazon Points offered with the purchase of an item. No Type: Points

PrimeInformation

Amazon Prime information.

PrimeInformation Elements

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

SalesRank

The sales rank of the item in the given product category.

SalesRank Elements

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

SellerFeedbackRating

Information about the seller's feedback, including the percentage of positive feedback, and the total count of feedback received.

SellerFeedbackRating Elements

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

ShipsFrom

The state and country from where the item is shipped.

ShipsFrom Elements

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

Related topics