listings_getListingsItem
Get the SELLER'S SUBMITTED attributes, status, and issues for a single listing SKU.
readAmazon Seller (SP-API)sp.listingsItems_2021-08-01
Amazon SP-API · getListingsItem · GET /listings/2021-08-01/items/{sellerId}/{sku} Account types: Seller Central + Vendor Central (vendors pass seller_id) This returns what the seller sent to Amazon — NOT what the detail page shows. Amazon may override these values with data from other sellers or its own sources. To see whether Amazon kept your values, compare data.attributes with catalogItems_getCatalogItem's data.item.attributes for the ASIN — a difference means Amazon chose another contribution. Use to inspect a listing before making changes, or to verify that a listings_putListingsItem / listings_patchListingsItem took effect. Fix a flagged attribute with listings_patchListingsItem on the issue's attributeNames.
Call it
In an AI client (MCP)
{
"name": "listings_getListingsItem",
"arguments": {
"store": "myStore-US",
"sku": "<sku>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/listings_getListingsItem \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","sku":"<sku>"}'Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
skurequired | string | Merchant SKU (msku). |
included_data | string[] | datasets to return; default ['summaries', 'issues', 'attributes', 'fulfillmentAvailability']. procurement is for vendors only. Allowed: summaries | attributes | issues | offers | fulfillmentAvailability | procurement | relationships | productTypes.summariesattributesissuesoffersfulfillmentAvailabilityprocurementrelationshipsproductTypes |
issue_locale | string | locale of Amazon's issue messages (e.g. 'en_US'); defaults to the marketplace's primary language. |
seller_id | string | Vendor Central accounts ONLY — pass your vendor code (e.g. 'ABCDE' from vendorOrders_getPurchaseOrders → orderDetails.sellingParty.partyId). Vendors may hold multiple codes across marketplaces/warehouses; pick the one for the marketplace you need. Do not pass this for Seller Central — the merchant token is used automatically. |
Result
Every tool answers {notification, data, human_action}; data carries:
data— Amazon's listing payload — the fields below.data.summaries[0].status— 'BUYABLE' (active and buyable) and/or 'DISCOVERABLE' (visible). A missing BUYABLE does not by itself mean suppressed (no stock, or a vendor listing — BUYABLE never applies to vendors).data.summaries[0].asin— the ASIN this SKU maps to.data.issues[]— {code, message, severity ERROR | WARNING | INFO, attributeNames, enforcements}. The listing is suppressed when an issue's enforcements.actions[].action is Amazon's listing-suppressed action (the others suppress one attribute, remove the catalog item, or hide it from search).data.attributes— dict of current attribute values in SP-API format.data.fulfillmentAvailability[]— qty by channel: - fulfillmentChannelCode 'DEFAULT' = FBM (merchant-fulfilled) - fulfillmentChannelCode 'AMAZON_NA' / 'AMAZON_EU' = FBA