---
updatedAt: 2026-09-09T22:43:31.000Z
agentTools:
siteIndex: https://developer-docs.amazon/llms.txt
projectIndex: https://developer-docs.amazon/sp-api/llms.txt
---
# Listings Items API
Learn how to access data on selling partner listings on Amazon.
| Current version | Legacy versions | Availability | Sandbox |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------ | :------ |
| v2021-08-01 ([Reference](https://developer-docs.amazon/sp-api/reference/listings-items-v2020-09-01) \| [Model](https://github.com/amzn/selling-partner-api-models/blob/main/models/listings-items-api-model/listingsItems_2021-08-01.json "Access the JSON schema model for the Listings Items API.")) | [v2020-09-01](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2020-09-01 "Access the legacy documentation for the Listings Items API.") | Sellers and Vendors | Static |
Release notes
\- [September 30, 2026](https://developer-docs.amazon/sp-api/docs/sp-api-release-notes#september-30-2026)
* [July 29, 2026](https://developer-docs.amazon/sp-api/docs/sp-api-release-notes#july-29-2026)
* [May 28, 2025](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#may-28-2025)
* [December 18, 2024](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#december-18-2024)
* [September 11, 2024](https://developer-docs.amazon.com/sp-api/page/release-notes#september-11-2024)
* [January 31, 2024](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#january-31-2024)
* [December 13, 2023](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#december-13-2023)
* [October 11, 2023](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#october-11-2023)
* [June 21, 2023](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#june-21-2023)
To learn more about the terms that are used on this page, refer to [Terminology](https://developer-docs.amazon.com/sp-api/docs/terminology).
## Use cases
The following use case examples are available for the Listings Items API:
* [Retrieve details about a listing for single or multiple Amazon stores](https://developer-docs.amazon.com/sp-api/docs/retrieve-details-about-a-listing): Return detailed information about an Amazon listing for a given selling partner and single or multiple Amazon stores. The details returned can include a number of optional datasets that provide important information about the state of the listing.
* [Preview errors before creating or fully updating a listing](https://developer-docs.amazon.com/sp-api/docs/preview-errors-before-creating-a-listing): Preview errors before creating or fully updating an Amazon listing for a given selling partner and Amazon store.
* [Create or fully update a listing](https://developer-docs.amazon.com/sp-api/docs/create-a-listing): Create or fully update an Amazon listing for a given selling partner and Amazon store.
* [Preview errors before partially updating a listing](https://developer-docs.amazon.com/sp-api/docs/preview-errors-before-partially-updating-a-listing): Preview errors before partially updating an Amazon listing for a given selling partner and Amazon store using the Listings Items API.
* [Partially update a listing](https://developer-docs.amazon.com/sp-api/docs/partially-update-a-listing): Partially update an Amazon listing for a given selling partner and Amazon store using the Listings Items API.
* [Merge a listing](https://developer-docs.amazon.com/sp-api/docs/merge-a-listing): Partially update the `quantity` field within the `fulfillment_availability` without the need to explicitly specify other optional attributes such as `restock_date` and `lead_time_to_ship_max_days`. You can also delete previously set values for `quantity_discount_plan` within the `purchasable_offer` for B2B offers. **The merge operation is not supported for other attributes outside of `fulfillment_availability` and `purchasable_offer`**. For granular updates to all `purchasable_offer` sub-attributes, refer to [Manage purchasable offer](https://developer-docs.amazon.com/sp-api/docs/manage-purchasable-offer).
* [Delete a listing](https://developer-docs.amazon.com/sp-api/docs/delete-a-listing): Delete an Amazon listing for a given selling partner and Amazon store using the Listings Items API.
* [Submit media attributes](https://developer-docs.amazon.com/sp-api/docs/submit-media): Submit image and other media attributes.
* [Manage purchasable offer](https://developer-docs.amazon.com/sp-api/docs/manage-purchasable-offer): Update an Amazon purchasable offer for a given selling partner and Amazon store using the Listings Items API.
* [Update prices for multiple Amazon stores](https://developer-docs.amazon.com/sp-api/docs/update-price-for-multiple-amazon-stores): Submit price updates for two or more Amazon stores.
* [Search for listings items by product identifier (or other listings parameters)](https://developer-docs.amazon.com/sp-api/docs/search-for-listings-items-by-id): Retrieve information about multiple listings based on SKU, ASIN, or supported product identifiers for single or multiple Amazon stores in the same region. Responses can include a number of optional datasets that provide important information about the state of a listing.
## Considerations
* **1x1 updates**: The Listings Items API accepts listings updates one at a time. For use-cases better suited to bulk uploads, the `JSON_LISTINGS_FEED` feed type can be used with the Selling Partner API for Feeds. The `JSON_LISTINGS_FEED` is the bulk equivalent of the Listings Items API, offering the same features and schemas provided by the Selling Partner API for Product Type Definitions.
* **Fully supported product types**: The Listings Items API does not yet fully support all Amazon <>s. Supported Amazon product types differ by selling partner type (merchant or vendor) and by Amazon store. Refer to the Selling Partner API for Product Type Definitions for the latest available Amazon product types.
* **Partially supported product types**: For Amazon product types not yet fully supported by the Listings Items API, offer-only submissions for existing ASINs and <>s are supported by using the `PRODUCT` product type.
* **Results and issues**: Responses from the Listings Items `putListingsItem`, `patchListingsItem` and `deleteListingsItem` operations indicate whether or not the submission was accepted for processing, along with any issues preventing the submission from being accepted. Responses do not include issues that occur after accepting the submission for processing. Responses to the Listings Items `getListingsItem` operation can include issues that occur after the submission has been processed.
* **Attributes**: The attributes section shows the latest data provided by the selling partner. Other sections, such as `fulfillmentAvailability`, represent the latest live data for the listing. For example, if the last inventory quantity submitted was `1` and that item is sold, the attributes section shows `1` as the latest value and the `fulfillmentAvailability` section shows `0` as the live quantity available for purchase.
* **`putListingsItem` updates**: The [`putListingsItem`](https://developer-docs.amazon.com/sp-api/reference/putlistingsitem-1) operation creates a new listing or [replaces the existing content of a listing](https://www.rfc-editor.org/rfc/rfc2616#section-9.6). Existing attributes may be dropped if omitted from the `putListingsItem` submission. For example, if the listing previously contained bullet points and a `putListingsItem` submission is made with the `LISTING_OFFER_ONLY` requirements without including the bullet points, the `putListingsItem` submission will remove the bullet points content on existing listings.
## Roles for the Listings Items API v2021-08-01
deleteListingsItem
| Attribute | Value |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Regions | NA, EU, FE |
| Required roles (need at least one) | [Inventory and Order Tracking](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#inventory-and-order-tracking)
[Product Listing](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#product-listing) |
getListingsItem
| Attribute | Value |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Regions | NA, EU, FE |
| Required roles (need at least one) | [Inventory and Order Tracking](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#inventory-and-order-tracking)
[Product Listing](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#product-listing) |
patchListingsItem
| Attribute | Value |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Regions | NA, EU, FE |
| Required roles (need at least one) | [Inventory and Order Tracking](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#inventory-and-order-tracking)
[Product Listing](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#product-listing) |
putListingsItem
| Attribute | Value |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Regions | NA, EU, FE |
| Required roles (need at least one) | [Inventory and Order Tracking](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#inventory-and-order-tracking)
[Product Listing](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#product-listing) |
searchListingsItems
| Attribute | Value |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Regions | NA, EU, FE |
| Required roles (need at least one) | [Inventory and Order Tracking](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#inventory-and-order-tracking)
[Product Listing](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#product-listing) |