Amazon SP API
  1. Listings Items
Amazon SP API
  • Overview
  • Authorization Workflow
  • Permissions
  • Sandbox
  • API Models
  • Available API Models
  • Request Apidog Access
  • OPENAPI SPECIFICATION
  • Research Docs
    • Amazon Seller Order Fulfillment Workflow
  • Amazon Warehousing and Distribution
    • getInboundShipment
      GET
    • listInboundShipments
      GET
    • listInventory
      GET
  • Authorization
    • Authorization
      POST
  • Catalog Items
    • searchCatalogItems
      GET
    • getCatalogItem
      GET
  • Catalog [Deprecated]
    • listCatalogItems
      GET
    • getCatalogItem
      GET
    • listCatalogCategories
      GET
  • Definitions
    • searchDefinitionsProductTypes
      GET
    • getDefinitionsProductType
      GET
  • Easy Ship
    • listHandoverSlots
    • getScheduledPackage
    • createScheduledPackage
    • updateScheduledPackages
    • createScheduledPackageBulk
  • 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
    • getInventorySummaries
    • createInventoryItem
    • deleteInventoryItem
    • addInventory
  • FBAOutbound
    • getFulfillmentPreview
    • deliveryOffers
    • listAllFulfillmentOrders
    • createFulfillmentOrder
    • getPackageTrackingDetails
    • listReturnReasonCodes
    • createFulfillmentReturn
    • getFulfillmentOrder
    • updateFulfillmentOrder
    • cancelFulfillmentOrder
    • submitFulfillmentOrderStatusUpdate
    • getFeatures
    • getFeatureInventory
    • getFeatureSKU
  • Feeds
    • getFeeds
    • createFeed
    • cancelFeed
    • getFeed
    • createFeedDocument
    • getFeedDocument
  • Fees
    • getMyFeesEstimateForSKU
    • getMyFeesEstimateForASIN
    • getMyFeesEstimates
  • Finance
    • listTransactions
    • listFinancialEventGroups
    • listFinancialEventsByGroupId
    • listFinancialEventsByOrderId
    • listFinancialEvents
  • Invoices [Brazil]
    • getInvoicesAttributes
    • getInvoicesDocument
    • createInvoicesExport
    • getInvoicesExports
    • getInvoicesExport
    • getInvoices
    • getInvoice
  • Listings Items
    • getListingsRestrictions
      GET
    • deleteListingsItem
      DELETE
    • getListingsItem
      GET
    • patchListingsItem
      PATCH
    • putListingsItem
      PUT
  • Merchant Fulfillment
    • getEligibleShipmentServices
    • getShipment
    • cancelShipment
    • createShipment
    • getAdditionalSellerInputs
  • Orders
    • getOrders
    • getOrder
    • getOrderBuyerInfo
    • getOrderAddress
    • getOrderItems
    • getOrderItemsBuyerInfo
    • updateShipmentStatus
    • getOrderRegulatedInfo
    • updateVerificationStatus
    • confirmShipment
  • ProductPricing
    • deprecated
      • getPricing
      • getCompetitivePricing
      • getListingOffers
      • getItemOffers
      • getItemOffersBatch
      • getListingOffersBatch
    • getFeaturedOfferExpectedPriceBatch
    • getCompetitiveSummary
  • Reports
    • getReports
    • createReport
    • cancelReport
    • getReport
    • getReportSchedules
    • createReportSchedule
    • cancelReportSchedule
    • getReportSchedule
    • getReportDocument
  • Sales
    • getOrderMetrics
  • Sellers
    • getMarketplaceParticipations
    • getAccount
  • Service
    • getServiceJobByServiceJobId
    • cancelServiceJobByServiceJobId
    • completeServiceJobByServiceJobId
    • getServiceJobs
    • addAppointmentForServiceJobByServiceJobId
    • rescheduleAppointmentForServiceJobByServiceJobId
    • assignAppointmentResources
    • setAppointmentFulfillmentData
    • getRangeSlotCapacity
    • getFixedSlotCapacity
    • updateSchedule
    • createReservation
    • updateReservation
    • cancelReservation
    • getAppointmmentSlotsByJobId
    • getAppointmentSlots
    • createServiceDocumentUploadDestination
  • ShipmentInvoice[Brazil]
    • getShipmentDetails
    • submitInvoice
    • getInvoiceStatus
  • 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
    • getSupplySources
    • createSupplySource
    • getSupplySource
    • updateSupplySource
    • archiveSupplySource
    • updateSupplySourceStatus
  • Tokens
    • createRestrictedDataToken
  • Uploads
    • createUploadDestinationForResource
  • Notifications
    • getSubscription
    • createSubscription
    • getSubscriptionById
    • deleteSubscriptionById
    • getDestinations
    • createDestination
    • getDestination
    • deleteDestination
  1. Listings Items

getListingsItem

Integrating
GET
/listings/2021-08-01/items/{sellerId}/{sku}
Listings Items
Last modified:2024-12-11 06:11:07
Maintainer:Not configured
Returns details about a listings item for a selling partner.
Note: The parameters associated with this operation may contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when encoding URLs, refer to URL Encoding.
Usage Plan:
Rate (requests per second)Burst
510
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.

Request

Path Params
sellerId
string 
required
A selling partner identifier, such as a merchant account or vendor code.
sku
string 
required
A selling partner provided identifier for an Amazon listing.
Query Params
marketplaceIds
array[string]
required
A comma-delimited list of Amazon marketplace identifiers for the request.
<= 1 items
Example:
ATVPDKIKX0DER
issueLocale
string 
optional
A locale for localization of issues. When not provided, the default language code of the first marketplace is used. Examples: 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
A comma-delimited list of data sets to include in the response. Default: 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
Success.
Headers
x-amzn-RateLimit-Limit
string 
optional
Your rate limit (requests per second) for this operation.
x-amzn-RequestId
string 
optional
Unique request reference identifier.
Body
A listings item.
sku
string 
required
A selling partner provided identifier for an Amazon listing.
summaries
array[object (ItemSummaryByMarketplace) {10}] 
optional
Summary details of a listings item.
marketplaceId
string 
required
A marketplace identifier. Identifies the Amazon marketplace for the listings item.
asin
string 
required
Amazon Standard Identification Number (ASIN) of the listings item.
productType
string 
required
The Amazon product type of the listings item.
conditionType
enum<string> 
optional
Identifies the condition of the listings item.
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
Statuses that apply to the listings item.
Allowed values:
BUYABLEDISCOVERABLE
fnSku
string 
optional
The fulfillment network stock keeping unit is an identifier used by Amazon fulfillment centers to identify each unique item.
itemName
string 
required
The name or title associated with an Amazon catalog item.
createdDate
string <date-time>
required
The date the listings item was created in ISO 8601 format.
lastUpdatedDate
string <date-time>
required
The date the listings item was last updated in ISO 8601 format.
mainImage
object (ItemImage) 
optional
The image for the listings item.
attributes
object (ItemAttributes) 
optional
A JSON object containing structured listings item attribute data keyed by attribute name.
Additional properties
integer  | number  | string  | boolean 
optional
issues
array[object (Issue) {6}] 
optional
The issues associated with the listings item.
code
string 
required
An issue code that identifies the type of issue.
message
string 
required
A message that describes the issue.
severity
enum<string> 
required
The severity of the issue.
Allowed values:
ERRORWARNINGINFO
attributeNames
array[string]
optional
The names of the attributes associated with the issue, if applicable.
categories
array[string]
required
List of issue categories.
Possible vales:
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
This field provides information about the enforcement actions taken by Amazon that affect the publishing or status of a listing. It also includes details about any associated exemptions.
offers
array[object (ItemOfferByMarketplace) {5}] 
optional
Offer details for the listings item.
marketplaceId
string 
required
The Amazon marketplace identifier.
offerType
enum<string> 
required
Type of offer for the listings item.
Allowed values:
B2CB2B
price
object (Money) 
required
The currency type and amount.
points
object (Points) 
optional
The number of Amazon Points that are offered with the purchase of an item and the monetary value of these points.
audience
object (Audience) 
optional
Buyer segment or program this offer is applicable to.
fulfillmentAvailability
array[object (FulfillmentAvailability) {2}] 
optional
The fulfillment availability for the listings item.
fulfillmentChannelCode
string 
required
The code of the fulfillment network that will be used.
quantity
integer 
optional
The quantity of the item you are making available for sale.
>= 0
procurement
array[object (ItemProcurement) {1}] 
optional
The vendor procurement information for the listings item.
costPrice
object (Money) 
required
The currency type and amount.
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
Previous
deleteListingsItem
Next
patchListingsItem
Built with