--- updatedAt: 2026-09-10T19:06:00.000Z agentTools: siteIndex: https://developer-docs.amazon/llms.txt projectIndex: https://developer-docs.amazon/sp-api/llms.txt --- # getListingsItem Returns details about a listings item for a selling partner. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 5 | 10 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput can receive higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api) in the Selling Partner API documentation. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "description": "The Selling Partner API for Listings Items (Listings Items API) provides programmatic access to selling partner listings on Amazon. Use this API in collaboration with the Selling Partner API for Product Type Definitions, which you can use to retrieve the information about Amazon product types needed to use the Listings Items API.\n\nFor more information, refer to the [Listings Items API Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-use-case-guide).", "version": "2021-08-01", "title": "Listings Items v2021-08-01", "contact": { "name": "Selling Partner API Developer Support", "url": "https://sellercentral.amazon.com/gp/mws/contactus.html" }, "license": { "name": "Apache License 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0" } }, "paths": { "/listings/2021-08-01/items/{sellerId}/{sku}": { "get": { "tags": [ "Listings Items v2021-08-01" ], "description": "Returns details about a listings item for a selling partner.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 10 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput can receive higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api) in the Selling Partner API documentation.", "operationId": "getListingsItem", "parameters": [ { "name": "sellerId", "description": "A selling partner identifier, such as a merchant account or vendor code.", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "sku", "description": "A selling partner-provided identifier for an Amazon listing.", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "marketplaceIds", "description": "A comma-delimited list of Amazon store identifiers for the request.", "in": "query", "required": true, "example": "ATVPDKIKX0DER", "style": "form", "explode": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "issueLocale", "description": "A locale for localization of issues. When not provided, the default language code of the first Amazon store is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US` when localization is not available for the specified locale.", "in": "query", "required": false, "example": "en_US", "schema": { "type": "string" } }, { "name": "includedData", "description": "A comma-delimited list of data sets to include in the response. Default: `summaries`.", "in": "query", "required": false, "example": "summaries", "style": "form", "explode": false, "schema": { "type": "array", "items": { "enum": [ "summaries", "attributes", "issues", "offers", "fulfillmentAvailability", "procurement", "relationships", "productTypes" ], "x-docgen-enum-table-extension": [ { "value": "summaries", "description": "Summary details of the listing item." }, { "value": "attributes", "description": "JSON object containing structured listing item attribute data keyed by attribute name." }, { "value": "issues", "description": "Issues associated with the listing item." }, { "value": "offers", "description": "Current offers for the listing item." }, { "value": "fulfillmentAvailability", "description": "Fulfillment availability details for the listing item." }, { "value": "procurement", "description": "Vendor procurement details for the listing item." }, { "value": "relationships", "description": "Relationship details for a listing item (for example, variations)." }, { "value": "productTypes", "description": "Product types that are associated with a listing item." } ], "type": "string" }, "default": [ "summaries" ] } } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } }, "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": {} } }, "response": { "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 } }, { "marketplaceId": "A2EUQ1WTGCTBG2", "asin": "B071VG5N9D", "productType": "LUGGAGE", "conditionType": "new_new", "status": [], "itemName": "Hardside Carry-On Spinner Suitcase Luggage", "createdDate": "2021-02-02T01:00:00Z", "lastUpdatedDate": "2021-03-05T00: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" }, "replenishmentDiscount": { "discountPercentage": 5 }, "quantityDiscountPlan": { "discountType": "PERCENT", "levels": [ { "lowerBound": 5, "value": "5.0" }, { "lowerBound": 10, "value": "10.0" }, { "lowerBound": 25, "value": "15.0" } ] } }, { "marketplaceId": "A2EUQ1WTGCTBG2", "offerType": "B2C", "price": { "currencyCode": "CAD", "amount": "130.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", "LISTING" ], "marketplaceIds": [ "ATVPDKIKX0DER" ] }, { "code": "18027", "message": "We believe the main image has text, logo, graphic, or watermark that is not permitted for this product type. Submit a compliant image to lift the suppression. Also refer to Product image requirements.", "severity": "ERROR", "categories": [ "INVALID_IMAGE", "LISTING" ], "enforcements": { "actions": [ { "action": "SEARCH_SUPPRESSED" } ], "exemption": { "status": "EXEMPT_UNTIL_EXPIRY_DATE", "expiryDate": "2025-05-28T00:36:48.914Z" } }, "marketplaceIds": [ "ATVPDKIKX0DER", "A2EUQ1WTGCTBG2" ] }, { "code": "99300", "message": "Product Detail Page Rules Violation (Inaccurate information on product detail page).", "severity": "ERROR", "categories": [ "PRODUCT" ], "enforcements": { "actions": [ { "action": "ATTRIBUTE_SUPPRESSED" } ], "exemption": { "status": "EXEMPT" } }, "marketplaceIds": [ "ATVPDKIKX0DER", "A2EUQ1WTGCTBG2" ] }, { "code": "18155", "message": "The 'minimum price' is greater than the selling price (excluding shipping) for the listing. Review and update your price and/or minimum price.", "severity": "ERROR", "categories": [ "INVALID_PRICE", "LISTING" ], "enforcements": { "actions": [ { "action": "LISTING_SUPPRESSED" } ], "exemption": { "status": "NOT_EXEMPT" } }, "marketplaceIds": [ "ATVPDKIKX0DER" ] }, { "code": "18742", "message": "Restricted Products Policy Violation", "severity": "ERROR", "categories": [ "PRODUCT" ], "enforcements": { "actions": [ { "action": "CATALOG_ITEM_REMOVED" } ], "exemption": { "status": "NOT_EXEMPT" } }, "marketplaceIds": [ "ATVPDKIKX0DER" ] } ] } } ] }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Item" }, "examples": { "response": { "value": { "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 } }, { "marketplaceId": "A2EUQ1WTGCTBG2", "asin": "B071VG5N9D", "productType": "LUGGAGE", "conditionType": "new_new", "status": [], "itemName": "Hardside Carry-On Spinner Suitcase Luggage", "createdDate": "2021-02-02T01:00:00Z", "lastUpdatedDate": "2021-03-05T00: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" }, "replenishmentDiscount": { "discountPercentage": 5 }, "quantityDiscountPlan": { "discountType": "PERCENT", "levels": [ { "lowerBound": 5, "value": "5.0" }, { "lowerBound": 10, "value": "10.0" }, { "lowerBound": 25, "value": "15.0" } ] } }, { "marketplaceId": "A2EUQ1WTGCTBG2", "offerType": "B2C", "price": { "currencyCode": "CAD", "amount": "130.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", "LISTING" ], "marketplaceIds": [ "ATVPDKIKX0DER" ] }, { "code": "18027", "message": "We believe the main image has text, logo, graphic, or watermark that is not permitted for this product type. Submit a compliant image to lift the suppression. Also refer to Product image requirements.", "severity": "ERROR", "categories": [ "INVALID_IMAGE", "LISTING" ], "enforcements": { "actions": [ { "action": "SEARCH_SUPPRESSED" } ], "exemption": { "status": "EXEMPT_UNTIL_EXPIRY_DATE", "expiryDate": "2025-05-28T00:36:48.914Z" } }, "marketplaceIds": [ "ATVPDKIKX0DER", "A2EUQ1WTGCTBG2" ] }, { "code": "99300", "message": "Product Detail Page Rules Violation (Inaccurate information on product detail page).", "severity": "ERROR", "categories": [ "PRODUCT" ], "enforcements": { "actions": [ { "action": "ATTRIBUTE_SUPPRESSED" } ], "exemption": { "status": "EXEMPT" } }, "marketplaceIds": [ "ATVPDKIKX0DER", "A2EUQ1WTGCTBG2" ] }, { "code": "18155", "message": "The 'minimum price' is greater than the selling price (excluding shipping) for the listing. Review and update your price and/or minimum price.", "severity": "ERROR", "categories": [ "INVALID_PRICE", "LISTING" ], "enforcements": { "actions": [ { "action": "LISTING_SUPPRESSED" } ], "exemption": { "status": "NOT_EXEMPT" } }, "marketplaceIds": [ "ATVPDKIKX0DER" ] }, { "code": "18742", "message": "Restricted Products Policy Violation", "severity": "ERROR", "categories": [ "PRODUCT" ], "enforcements": { "actions": [ { "action": "CATALOG_ITEM_REMOVED" } ], "exemption": { "status": "NOT_EXEMPT" } }, "marketplaceIds": [ "ATVPDKIKX0DER" ] } ] } } } } } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } }, "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "sku": { "value": "BadSKU" } } }, "response": { "errors": [ { "code": "BAD_REQUEST", "message": "Invalid input", "details": "Invalid input" } ] } } ] }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "403": { "description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } }, "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "413": { "description": "The request size exceeded the maximum accepted size.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "415": { "description": "The request payload is in an unsupported format.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } } }, "summary": "getListingsItem" } } }, "x-readme": { "explorer-enabled": false }, "servers": [ { "url": "https://sellingpartnerapi-na.amazon.com" } ], "components": { "schemas": { "Error": { "description": "Error response returned when the request is unsuccessful.", "properties": { "code": { "description": "An error code that identifies the type of error that occurred.", "type": "string" }, "message": { "description": "A message that describes the error condition.", "type": "string" }, "details": { "description": "Additional details that can help the caller understand or fix the issue.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "ErrorList": { "description": "A list of error responses returned when a request is unsuccessful.", "type": "object", "properties": { "errors": { "description": "A list of error responses.", "type": "array", "items": { "$ref": "#/components/schemas/Error" } } }, "required": [ "errors" ] }, "Item": { "description": "A listings item.", "properties": { "sku": { "description": "A selling partner-provided identifier for an Amazon listing.", "type": "string" }, "summaries": { "$ref": "#/components/schemas/ItemSummaries" }, "attributes": { "$ref": "#/components/schemas/ItemAttributes" }, "issues": { "$ref": "#/components/schemas/ItemIssues" }, "offers": { "$ref": "#/components/schemas/ItemOffers" }, "fulfillmentAvailability": { "description": "The listings item's fulfillment availability.", "type": "array", "items": { "$ref": "#/components/schemas/FulfillmentAvailability" } }, "procurement": { "description": "The listings item's vendor procurement information.", "type": "array", "items": { "$ref": "#/components/schemas/ItemProcurement" } }, "relationships": { "$ref": "#/components/schemas/ItemRelationships" }, "productTypes": { "$ref": "#/components/schemas/ItemProductTypes" } }, "required": [ "sku" ], "type": "object" }, "ItemSummaries": { "description": "Summary details for a listings item.", "items": { "$ref": "#/components/schemas/ItemSummaryByMarketplace" }, "type": "array" }, "ItemSummaryByMarketplace": { "description": "Summary details for a listings item for an Amazon store.", "properties": { "marketplaceId": { "description": "An Amazon store identifier. Identifies the listings item's Amazon store.", "type": "string" }, "asin": { "description": "The ASIN of the listings item.", "type": "string" }, "productType": { "description": "The listings item's Amazon product type.", "type": "string" }, "conditionType": { "description": "Identifies the condition of the listings item.", "enum": [ "new_new", "new_open_box", "new_oem", "refurbished_refurbished", "used_like_new", "used_very_good", "used_good", "used_acceptable", "collectible_like_new", "collectible_very_good", "collectible_good", "collectible_acceptable", "club_club" ], "x-docgen-enum-table-extension": [ { "value": "new_new", "description": "New" }, { "value": "new_open_box", "description": "New - Open Box." }, { "value": "new_oem", "description": "New - OEM." }, { "value": "refurbished_refurbished", "description": "Refurbished" }, { "value": "used_like_new", "description": "Used - Like New." }, { "value": "used_very_good", "description": "Used - Very Good." }, { "value": "used_good", "description": "Used - Good." }, { "value": "used_acceptable", "description": "Used - Acceptable." }, { "value": "collectible_like_new", "description": "Collectible - Like New." }, { "value": "collectible_very_good", "description": "Collectible - Very Good." }, { "value": "collectible_good", "description": "Collectible - Good." }, { "value": "collectible_acceptable", "description": "Collectible - Acceptable." }, { "value": "club_club", "description": "Club" } ], "type": "string" }, "status": { "description": "Statuses that apply to the listings item.", "type": "array", "items": { "type": "string", "enum": [ "BUYABLE", "DISCOVERABLE" ], "x-docgen-enum-table-extension": [ { "value": "BUYABLE", "description": "The listings item can be purchased by shoppers. This status does not apply to vendor listings." }, { "value": "DISCOVERABLE", "description": "The listings item is visible to shoppers." } ] } }, "fnSku": { "description": "Fulfillment network stock keeping unit is an identifier used by Amazon fulfillment centers to identify each unique item.", "type": "string" }, "itemName": { "description": "Name, or title, associated with an Amazon catalog item.", "type": "string" }, "createdDate": { "description": "Date the listings item was created, in ISO 8601 format.", "type": "string", "format": "date-time" }, "lastUpdatedDate": { "description": "Date the listings item was last updated, in ISO 8601 format.", "type": "string", "format": "date-time" }, "mainImage": { "$ref": "#/components/schemas/ItemImage" } }, "required": [ "marketplaceId", "productType", "status", "createdDate", "lastUpdatedDate" ], "type": "object" }, "ItemImage": { "description": "The listings item's image.", "properties": { "link": { "description": "The image's link or URL.", "type": "string" }, "height": { "description": "The image's height, in pixels.", "type": "integer" }, "width": { "description": "The image's width, in pixels.", "type": "integer" } }, "required": [ "link", "height", "width" ], "type": "object" }, "ItemAttributes": { "description": "JSON object containing structured listings item attribute data keyed by attribute name.", "type": "object", "additionalProperties": true }, "ItemIssues": { "description": "Issues associated with the listings item.", "items": { "$ref": "#/components/schemas/Issue" }, "type": "array" }, "Issue": { "description": "An issue with a listings item.", "properties": { "code": { "description": "An issue code that identifies the type of issue.", "type": "string" }, "message": { "description": "A message that describes the issue.", "type": "string" }, "severity": { "description": "The severity of the issue.", "enum": [ "ERROR", "WARNING", "INFO" ], "x-docgen-enum-table-extension": [ { "value": "ERROR", "description": "Indicates an issue has occurred preventing the submission from processing, such as a validation error." }, { "value": "WARNING", "description": "Indicates an issue has occurred that should be reviewed, but has not prevented the submission from processing." }, { "value": "INFO", "description": "Indicates additional information has been provided that should be reviewed." } ], "type": "string" }, "attributeNames": { "description": "Names of the attributes that are associated with the issue, if applicable.", "type": "array", "items": { "type": "string" } }, "categories": { "description": "List of issue categories.", "type": "array", "items": { "type": "string", "x-docgen-enum-table-extension": [ { "value": "INVALID_ATTRIBUTE", "description": "One or more attributes are invalid." }, { "value": "MISSING_ATTRIBUTE", "description": "One or more required attributes are missing." }, { "value": "INVALID_IMAGE", "description": "One or more images are invalid." }, { "value": "MISSING_IMAGE", "description": "One or more required images are missing." }, { "value": "INVALID_PRICE", "description": "One or more price attributes are invalid." }, { "value": "MISSING_PRICE", "description": "One or more required price attributes are missing." }, { "value": "DUPLICATE", "description": "The listing has potential duplicate problems, such as this ASIN potentially being a duplicate of another ASIN." }, { "value": "QUALIFICATION_REQUIRED", "description": "Approval or qualification is required to list the product." }, { "value": "PRODUCT", "description": "Issue applies to the product (ASIN)." }, { "value": "LISTING", "description": "Issue applies to the listing (SKU)." } ] }, "example": [ "INVALID_ATTRIBUTE" ] }, "enforcements": { "$ref": "#/components/schemas/IssueEnforcements" }, "marketplaceIds": { "description": "List of Amazon store identifiers.", "type": "array", "items": { "type": "string" } } }, "required": [ "code", "message", "severity", "categories" ], "type": "object" }, "IssueEnforcements": { "description": "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.", "type": "object", "properties": { "actions": { "description": "List of enforcement actions taken by Amazon that affect the publishing or status of a listing.", "type": "array", "items": { "$ref": "#/components/schemas/IssueEnforcementAction" } }, "exemption": { "$ref": "#/components/schemas/IssueExemption" } }, "required": [ "actions", "exemption" ] }, "IssueEnforcementAction": { "description": "An enforcement action that Amazon takes that affects the publishing or status of a listing.", "type": "object", "properties": { "action": { "description": "The enforcement action name.\n\nPossible values:\n\n* `LISTING_SUPPRESSED` - This enforcement takes down the current listing item's buyability.\n\n* `ATTRIBUTE_SUPPRESSED` - An attribute's value on the listing item is invalid, which causes it to be rejected by Amazon.\n\n* `CATALOG_ITEM_REMOVED` - This catalog item is inactive on Amazon, and all offers against it in the applicable Amazon store are non-buyable.\n\n* `SEARCH_SUPPRESSED` - This value indicates that the catalog item is hidden from search results.", "type": "string", "example": "LISTING_SUPPRESSED" } }, "required": [ "action" ] }, "IssueExemption": { "description": "The status of the listed enforcement actions. If applicable, includes information about the exemption expiry date.", "type": "object", "properties": { "status": { "description": "Indicates the current exemption status for the listed enforcement actions. It can take values such as `EXEMPT`, signifying permanent exemption, `EXEMPT_UNTIL_EXPIRY_DATE` indicating temporary exemption until a specified date, or `NOT_EXEMPT` signifying no exemptions, and enforcement actions were already applied.", "enum": [ "EXEMPT", "EXEMPT_UNTIL_EXPIRY_DATE", "NOT_EXEMPT" ], "x-docgen-enum-table-extension": [ { "value": "EXEMPT", "description": "This status is assigned to a product listing when it has been exempted from the listed enforcement actions. In cases of `EXEMPT`, Amazon acknowledges the existence of enforcement actions but ensures the user that these actions are not applied to the listing. The user is advised to consider addressing the issue, although enforcement actions are not taken." }, { "value": "EXEMPT_UNTIL_EXPIRY_DATE", "description": "This status indicates that a product listing has been granted a temporary exemption from the listed enforcement actions. The exemption remains in effect until a specified expiry date. After this date, Amazon enforces the listed actions. The `expiryDate` field provides the timestamp indicating when the temporary exemption ends, adhering to the ISO 8601 format." }, { "value": "NOT_EXEMPT", "description": "This status is assigned to a product listing when it has no exemptions from the listed enforcement actions. When the status is `NOT_EXEMPT`, it signifies that Amazon has already taken the specified enforcement actions. There is no exemption in place, and the listed actions are actively enforced." } ], "type": "string" }, "expiryDate": { "description": "The timestamp, in ISO 8601 format, when the temporary exemption expires and Amazon begins enforcing the listed actions.", "type": "string", "format": "date-time", "example": "2023-10-28T00:36:48.914Z" } }, "required": [ "status" ] }, "ItemOffers": { "description": "The listings item's offer details.", "items": { "$ref": "#/components/schemas/ItemOfferByMarketplace" }, "type": "array" }, "ItemOfferByMarketplace": { "description": "Offer details for a listings item for the specified Amazon store.", "properties": { "marketplaceId": { "description": "Amazon store identifier.", "type": "string" }, "offerType": { "description": "The listings item's offer type.", "enum": [ "B2C", "B2B" ], "x-docgen-enum-table-extension": [ { "value": "B2C", "description": "The offer on this listings item is available for Business to Consumer purchase, meaning that it is available to shoppers on Amazon retail sites." }, { "value": "B2B", "description": "The offer on this listings item is available for Business to Business purchase." } ], "type": "string" }, "price": { "$ref": "#/components/schemas/Money" }, "points": { "$ref": "#/components/schemas/Points" }, "audience": { "$ref": "#/components/schemas/Audience" }, "replenishmentDiscount": { "$ref": "#/components/schemas/ReplenishmentDiscount" }, "quantityDiscountPlan": { "$ref": "#/components/schemas/QuantityDiscountPlan" } }, "required": [ "marketplaceId", "offerType", "price" ], "type": "object" }, "ReplenishmentDiscount": { "description": "A replenishment discount set by the selling partner on the offer for Subscribe & Save subscriptions.", "type": "object", "properties": { "discountPercentage": { "description": "The seller-funded Subscribe & Save discount on the offer, as a percentage (0–100). For example, `5` means 5% off; `0` means the selling partner funds no discount.", "type": "integer" } }, "required": [ "discountPercentage" ] }, "QuantityDiscountPlan": { "description": "The active quantity discount plan for an offer. A quantity discount plan defines discounts on the offer price based on the purchase quantity. There are two types of discounts: fixed prices based on the order quantity, and percentage discounts on the price based on the order quantity.", "type": "object", "properties": { "discountType": { "description": "The quantity price type, indicating whether the quantity discount is a fixed price set in the local currency for each quantity threshold, or a percentage discount on the price.", "type": "string", "enum": [ "PERCENT", "FIXED" ], "x-docgen-enum-table-extension": [ { "value": "PERCENT", "description": "The quantity price is a percentage discount offered on the price for each quantity threshold. For example, a value of `5.0` means 5% off." }, { "value": "FIXED", "description": "The quantity price is a fixed price set in the local currency for each quantity threshold." } ] }, "levels": { "description": "The quantity discount levels that define the discount at each quantity threshold.", "type": "array", "items": { "$ref": "#/components/schemas/QuantityDiscountLevel" } } }, "required": [ "discountType", "levels" ] }, "QuantityDiscountLevel": { "description": "A quantity discount level, defining the discount applied when the purchase quantity meets a given threshold.", "type": "object", "properties": { "lowerBound": { "description": "The quantity threshold, which is the minimum purchase quantity necessary to receive the discount. The discount applies to all units when the quantity threshold is met.", "type": "integer" }, "value": { "$ref": "#/components/schemas/Decimal" } }, "required": [ "lowerBound", "value" ] }, "ItemProcurement": { "description": "The listings item's vendor procurement information.", "properties": { "costPrice": { "$ref": "#/components/schemas/Money" } }, "required": [ "costPrice" ], "type": "object" }, "ItemRelationships": { "description": "Relationships for a listing item, by Amazon store (for example, variations).", "items": { "$ref": "#/components/schemas/ItemRelationshipsByMarketplace" }, "type": "array" }, "ItemRelationshipsByMarketplace": { "description": "Relationship details for the listing item in the specified Amazon store.", "properties": { "marketplaceId": { "description": "Amazon store identifier.", "type": "string" }, "relationships": { "description": "Relationships for the listing item.", "items": { "$ref": "#/components/schemas/ItemRelationship" }, "type": "array" } }, "required": [ "marketplaceId", "relationships" ], "type": "object" }, "ItemRelationship": { "description": "The relationship details for a listing item.", "properties": { "childSkus": { "description": "Identifiers (SKUs) of the related items that are children of this listing item.", "items": { "type": "string" }, "type": "array" }, "parentSkus": { "description": "Identifiers (SKUs) of the related items that are parents of this listing item.", "items": { "type": "string" }, "type": "array" }, "variationTheme": { "$ref": "#/components/schemas/ItemVariationTheme" }, "type": { "description": "The type of relationship.", "example": "VARIATION", "enum": [ "VARIATION", "PACKAGE_HIERARCHY" ], "x-docgen-enum-table-extension": [ { "value": "VARIATION", "description": "The listing item in the request is a variation parent or variation child of the related listing items, indicated by SKU." }, { "value": "PACKAGE_HIERARCHY", "description": "The listing item in the request is a package container or is contained by the related listing items, indicated by SKU." } ], "type": "string" } }, "required": [ "type" ], "type": "object" }, "ItemVariationTheme": { "description": "A variation theme that indicates the combination of listing item attributes that define the variation family.", "properties": { "attributes": { "description": "The names of the listing item attributes that are associated with the variation theme.", "items": { "type": "string" }, "type": "array" }, "theme": { "description": "The variation theme that indicates the combination of listing item attributes that define the variation family.", "example": "COLOR_NAME/STYLE_NAME", "type": "string" } }, "required": [ "attributes", "theme" ], "type": "object" }, "ItemProductTypes": { "description": "Product types for a listing item, by Amazon store.", "items": { "$ref": "#/components/schemas/ItemProductTypeByMarketplace" }, "type": "array" }, "ItemProductTypeByMarketplace": { "description": "Product types that are associated with the listing item for the specified Amazon store.", "properties": { "marketplaceId": { "description": "Amazon store identifier.", "type": "string" }, "productType": { "description": "The name of the product type that is submitted by the Selling Partner.", "example": "LUGGAGE", "type": "string" } }, "required": [ "marketplaceId", "productType" ], "type": "object" }, "FulfillmentAvailability": { "description": "The listings item's fulfillment availability details.", "properties": { "fulfillmentChannelCode": { "description": "Designates which fulfillment network is used.", "type": "string" }, "quantity": { "description": "The item quantity that you're making available for sale.", "type": "integer", "minimum": 0 } }, "required": [ "fulfillmentChannelCode" ], "type": "object" }, "Money": { "description": "The currency type and the amount.", "properties": { "currencyCode": { "type": "string", "description": "Three-digit currency code. In ISO 4217 format." }, "amount": { "$ref": "#/components/schemas/Decimal" } }, "required": [ "amount", "currencyCode" ], "type": "object" }, "Decimal": { "type": "string", "description": "A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation." }, "Points": { "description": "The number of Amazon Points offered with the purchase of an item, and their monetary value. Note that the `Points` element is only returned in Japan (JP).", "type": "object", "properties": { "pointsNumber": { "description": "The number of Amazon Points offered with the purchase of an item, and their monetary value.", "type": "integer" } }, "required": [ "pointsNumber" ] }, "Audience": { "description": "Buyer segment or program this offer is applicable to.", "type": "object", "properties": { "value": { "description": "Name of the audience an offer is applicable to.\n\nCommon values:\n\n* 'ALL' - Standard offer audience for buyers on Amazon retail websites.\n\n* 'B2B' - Offer audience for Amazon Business website buyers.", "type": "string", "example": "ALL" }, "displayName": { "description": "Localized display name for the audience.", "type": "string" } } } } } } ```