- Overview
- Authorization Workflow
- Permissions
- Sandbox
- API Models
- Available API Models
- Request Apidog Access
- OPENAPI SPECIFICATION
- Research Docs
- Amazon Warehousing and Distribution
- Authorization
- Catalog Items
- Catalog [Deprecated]
- Definitions
- Easy Ship
- FBAInbound
- listInboundPlans
- createInboundPlan
- getInboundPlan
- listInboundPlanBoxes
- cancelInboundPlan
- listInboundPlanItems
- updateInboundPlanName
- listPackingGroupBoxes
- listPackingGroupItems
- setPackingInformation
- listPackingOptions
- generatePackingOptions
- confirmPackingOption
- listInboundPlanPallets
- listPlacementOptions
- generatePlacementOptions
- confirmPlacementOption
- getShipment
- listShipmentBoxes
- listShipmentContentUpdatePreviews
- generateShipmentContentUpdatePreviews
- getShipmentContentUpdatePreview
- confirmShipmentContentUpdatePreview
- getDeliveryChallanDocument
- listDeliveryWindowOptions
- generateDeliveryWindowOptions
- confirmDeliveryWindowOptions
- listShipmentItems
- updateShipmentName
- listShipmentPallets
- cancelSelfShipAppointment
- getSelfShipAppointmentSlots
- generateSelfShipAppointmentSlots
- scheduleSelfShipAppointment
- updateShipmentSourceAddress
- updateShipmentTrackingDetails
- listTransportationOptions
- generateTransportationOptions
- confirmTransportationOptions
- listItemComplianceDetails
- updateItemComplianceDetails
- createMarketplaceItemLabels
- listPrepDetails
- setPrepDetails
- getInboundOperationStatus
- getItemEligibilityPreview
- FBAInventory
- FBAOutbound
- Feeds
- Fees
- Finance
- Invoices [Brazil]
- Listings Items
- Merchant Fulfillment
- Orders
- ProductPricing
- Reports
- Sales
- Sellers
- Service
- getServiceJobByServiceJobId
- cancelServiceJobByServiceJobId
- completeServiceJobByServiceJobId
- getServiceJobs
- addAppointmentForServiceJobByServiceJobId
- rescheduleAppointmentForServiceJobByServiceJobId
- assignAppointmentResources
- setAppointmentFulfillmentData
- getRangeSlotCapacity
- getFixedSlotCapacity
- updateSchedule
- createReservation
- updateReservation
- cancelReservation
- getAppointmmentSlotsByJobId
- getAppointmentSlots
- createServiceDocumentUploadDestination
- ShipmentInvoice[Brazil]
- Shipping
- getRates
- createShipment
- directPurchaseShipment
- getShipment
- purchaseShipment
- cancelShipment
- oneClickShipment
- purchaseLabels
- getTracking
- retrieveShippingLabel
- getShipmentDocuments
- purchaseShipment
- cancelShipment
- getRates
- getAdditionalInputs
- getAccount
- getCarrierAccountFormInputs
- getTrackingInformation
- getCarrierAccounts
- linkCarrierAccount
- unlinkCarrierAccount
- generateCollectionForm
- getCollectionFormHistory
- getUnmanifestedShipments
- getCollectionForm
- getAccessPoints
- Supply Sources
- Tokens
- Uploads
- Notifications
getListingsItem
Integrating
GET
/listings/2021-08-01/items/{sellerId}/{sku}
Listings Items
Last modified:2024-12-11 06:11:07
Maintainer:Not configured
Rate (requests per second) | Burst |
---|---|
5 | 10 |
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.Request
Path Params
sellerId
stringÂ
required
sku
stringÂ
required
Query Params
marketplaceIds
array[string]
required
<= 1 items
Example:
ATVPDKIKX0DER
issueLocale
stringÂ
optional
en_US
, fr_CA
, fr_FR
. Localized messages default to en_US
when a localization is not available in the specified locale.Example:
en_US
includedData
array[string]
optional
summaries
.Allowed values:
summariesattributesissuesoffersfulfillmentAvailabilityprocurement
Default:
summaries
Example:
summaries
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://sandbox.sellingpartnerapi-na.amazon.com/listings/2021-08-01/items//?marketplaceIds=ATVPDKIKX0DER&issueLocale=en_US&includedData=summaries'
Responses
🟢200OK
application/json
Headers
x-amzn-RateLimit-Limit
stringÂ
optional
x-amzn-RequestId
stringÂ
optional
Body
A listings item.
sku
stringÂ
required
summaries
array[object (ItemSummaryByMarketplace) {10}]Â
optional
marketplaceId
stringÂ
required
asin
stringÂ
required
productType
stringÂ
required
conditionType
enum<string>Â
optional
Allowed values:
new_newnew_open_boxnew_oemrefurbished_refurbishedused_like_newused_very_goodused_goodused_acceptablecollectible_like_newcollectible_very_goodcollectible_goodcollectible_acceptableclub_club
status
array[string]
required
Allowed values:
BUYABLEDISCOVERABLE
fnSku
stringÂ
optional
itemName
stringÂ
required
createdDate
string <date-time>
required
lastUpdatedDate
string <date-time>
required
mainImage
object (ItemImage)Â
optional
attributes
object (ItemAttributes)Â
optional
Additional properties
integer  | number  | string  | booleanÂ
optional
issues
array[object (Issue) {6}]Â
optional
code
stringÂ
required
message
stringÂ
required
severity
enum<string>Â
required
Allowed values:
ERRORWARNINGINFO
attributeNames
array[string]
optional
categories
array[string]
required
INVALID_ATTRIBUTE
- Indicating an invalid attribute in the listing.MISSING_ATTRIBUTE
- Highlighting a missing attribute in the listing.INVALID_IMAGE
- Signifying an invalid image in the listing.MISSING_IMAGE
- Noting the absence of an image in the listing.INVALID_PRICE
- Pertaining to issues with the listing's price-related attributes.MISSING_PRICE
- Pointing out the absence of a price attribute in the listing.DUPLICATE
- Identifying listings with potential duplicate problems, such as this ASIN potentially being a duplicate of another ASIN.QUALIFICATION_REQUIRED
- Indicating that the listing requires qualification-related approval.Example:
["INVALID_ATTRIBUTE"]
enforcements
object (IssueEnforcements)Â
optional
offers
array[object (ItemOfferByMarketplace) {5}]Â
optional
marketplaceId
stringÂ
required
offerType
enum<string>Â
required
Allowed values:
B2CB2B
price
object (Money)Â
required
points
object (Points)Â
optional
audience
object (Audience)Â
optional
fulfillmentAvailability
array[object (FulfillmentAvailability) {2}]Â
optional
fulfillmentChannelCode
stringÂ
required
quantity
integerÂ
optional
>= 0
procurement
array[object (ItemProcurement) {1}]Â
optional
costPrice
object (Money)Â
required
Example
{
"sku": "GM-ZDPI-9B4E",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"asin": "B071VG5N9D",
"productType": "LUGGAGE",
"conditionType": "new_new",
"status": [
"BUYABLE"
],
"itemName": "Hardside Carry-On Spinner Suitcase Luggage",
"createdDate": "2021-02-01T00:00:00Z",
"lastUpdatedDate": "2021-03-01T00:00:00Z",
"mainImage": {
"link": "https://www.example.com/luggage.png",
"height": 500,
"width": 500
}
}
],
"offers": [
{
"marketplaceId": "ATVPDKIKX0DER",
"offerType": "B2C",
"price": {
"currencyCode": "USD",
"amount": "100.00"
},
"audience": {
"value": "ALL",
"displayName": "Sell on Amazon"
}
}
],
"fulfillmentAvailability": [
{
"fulfillmentChannelCode": "DEFAULT",
"quantity": 100
}
],
"issues": [
{
"code": "90220",
"message": "'size' is required but not supplied.",
"severity": "ERROR",
"attributeNames": [
"size"
],
"categories": [
"MISSING_ATTRIBUTE"
]
},
{
"code": "18027",
"message": "We believe the main image has text, logo, graphic or watermark which is not permitted for this product type. Please submit a compliant image to lift the suppression. Also refer to Product image requirements.",
"severity": "ERROR",
"categories": [
"INVALID_IMAGE"
],
"enforcements": {
"actions": [
{
"action": "SEARCH_SUPPRESSED"
}
],
"exemption": {
"status": "EXEMPT_UNTIL_EXPIRY_DATE",
"expiryDate": "2025-05-28T00:36:48.914Z"
}
}
},
{
"code": "99300",
"message": "Product Detail Page Rules Violation (Inaccurate information on product detail page)",
"severity": "ERROR",
"categories": [],
"enforcements": {
"actions": [
{
"action": "ATTRIBUTE_SUPPRESSED"
}
],
"exemption": {
"status": "EXEMPT"
}
}
},
{
"code": "18155",
"message": "The 'minimum price' is greater than the selling price (excluding shipping) for the listing. Please review and update your price and/or minimum price.",
"severity": "ERROR",
"categories": [
"INVALID_PRICE"
],
"enforcements": {
"actions": [
{
"action": "LISTING_SUPPRESSED"
}
],
"exemption": {
"status": "NOT_EXEMPT"
}
}
},
{
"code": "18742",
"message": "Restricted Products Policy Violation",
"severity": "ERROR",
"categories": [],
"enforcements": {
"actions": [
{
"action": "CATALOG_ITEM_REMOVED"
}
],
"exemption": {
"status": "NOT_EXEMPT"
}
}
}
]
}
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
🟠413413
🟠415415
🟠429429
🔴500Server Error
🔴503Service Unavailable