--- title: "Get listings item" method: GET path: "/api/v1/sp-api/listings/2021-08-01/items/{sku}" tags: ["SP-API Listings Items"] --- # Get listings item `GET /api/v1/sp-api/listings/2021-08-01/items/{sku}` ## Request - Base URL: `https://app.sellerassistant.app` (the document declares no server; this is the origin it was published from) - URL: `https://app.sellerassistant.app/api/v1/sp-api/listings/2021-08-01/items/{sku}` - Auth: one of: - API key in query parameter `api_key` - API key in header `X-Api-Key` Proxy to https://developer-docs.amazon.com/sp-api/reference/getlistingsitem. The limit is 60 requests per minute. Amazon seller account integration is required to make this request. You can do it [here](https://app.sellerassistant.app/integrations/seller-central). ## Response `200` Successful response - ListingsItem: A single selling partner listings item. - `sku` string: A selling partner provided identifier for an Amazon listing. - `summaries` ListingsItemSummary[]: Summary details of a listings item. - `marketplaceId` string: A marketplace identifier. Identifies the Amazon marketplace for the listings item. - `asin` string, nullable: Amazon Standard Identification Number (ASIN) of the listings item. - `productType` string: The Amazon product type of the listings item. - `conditionType` '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', nullable: Identifies the condition of the listings item. Allowed values: 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. - `status` string[]: Statuses that apply to the listings item. (e.g., BUYABLE: The listings item can be purchased by shoppers. DISCOVERABLE: The listings item is visible to shoppers.) - `fnSku` string, nullable: The fulfillment network stock keeping unit is an identifier used by Amazon fulfillment centers to identify each unique item. - `itemName` string: The name or title associated with an Amazon catalog item. - `createdDate` string, date-time: The date the listings item was created in ISO 8601 format. - `lastUpdatedDate` string, date-time: The date the listings item was last updated in ISO 8601 format. - `mainImage` Image: The image details for the listings item. - `link` string, url: URL to the image. - `height` integer, nullable: Image height in pixels. - `width` integer, nullable: Image width in pixels. - `attributes` object, nullable: A JSON object containing structured listings item attribute data keyed by attribute name. This structure is highly product-type-dependent. - `issues` ListingsItemIssue[], nullable: The issues associated with the listings item. - `code` string: An issue code that identifies the type of issue. - `message` string: A message that describes the issue. - `severity` 'ERROR' | 'WARNING' | 'INFO': The severity of the issue. ERROR: Indicates an issue has occurred preventing the submission from processing. WARNING: Indicates an issue has occurred that should be reviewed, but has not prevented the submission from processing. INFO: Indicates additional information has been provided that should be reviewed. - `attributeNames` string[], nullable: The names of the attributes associated with the issue, if applicable. - `categories` string[]: List of issue categories. Possible values: 'INVALID_ATTRIBUTE' - Invalid attribute; 'MISSING_ATTRIBUTE' - Missing attribute; 'INVALID_IMAGE' - Invalid image; 'MISSING_IMAGE' - Missing image; 'INVALID_PRICE' - Issues with price-related attributes; 'MISSING_PRICE' - Absence of a price attribute; 'DUPLICATE' - Potential duplicate listing (e.g., ASIN duplicate); 'QUALIFICATION_REQUIRED' - Listing requires qualification-related approval. - `enforcements` Enforcements: Enforcement actions and exemption status. - `actions` EnforcementAction[]: List of enforcement actions taken by Amazon that affect the publishing or status of a listing. - `action` 'LISTING_SUPPRESSED' | 'ATTRIBUTE_SUPPRESSED' | 'CATALOG_ITEM_REMOVED' | 'SEARCH_SUPPRESSED': The enforcement action name. **LISTING_SUPPRESSED**: Takes down the current listing item's buyability. **ATTRIBUTE_SUPPRESSED**: An attribute's value on the listing item is invalid, causing it to be rejected by Amazon. **CATALOG_ITEM_REMOVED**: This catalog item is inactive on Amazon, and all offers against it are non-buyable. **SEARCH_SUPPRESSED**: The catalog item is hidden from search results. - `exemption` Exemption: Exemption details for enforcement actions. - `status` 'EXEMPT' | 'EXEMPT_UNTIL_EXPIRY_DATE' | 'NOT_EXEMPT': This field indicates the current exemption status for the listed enforcement actions. **EXEMPT**: Permanent exemption. Amazon acknowledges the enforcement actions but assures they are not applied to the listing. **EXEMPT_UNTIL_EXPIRY_DATE**: Temporary exemption until a specified expiry date, after which Amazon will enforce the listed actions. **NOT_EXEMPT**: No exemptions are in place; Amazon has already taken the specified enforcement actions, and they are actively enforced. - `expiryDate` string, date-time: Represents the timestamp, in ISO 8601 format, that specifies the date when the temporary exemptions expires. - `identifiers` ListingsItemIdentifier[], nullable: Identity attributes associated with the item in the Amazon catalog, such as the ASIN. - `marketplaceId` string: A marketplace identifier. Identifies the Amazon marketplace for the listings item. - `asin` string: Amazon Standard Identification Number (ASIN) of the listings item. - `offers` ListingOfferPrice[], nullable: Offer details for the listings item. - `marketplaceId` string: The Amazon marketplace identifier. - `offerType` 'B2C' | 'B2B': Type of offer for the listings item. (B2C: Business to Consumer, B2B: Business to Business) - `price` CurrencyAmount: The currency type and amount. - `currencyCode` string: Three-digit currency code in ISO 4217 format. - `amount` string: A decimal number with no loss of precision. Follows RFC7159 for number representation. - `points` Points: 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). - `pointsNumber` integer: The number of points awarded. - `audience` OfferAudience: Buyer segment or program this offer is applicable to. - `value` 'ALL' | 'B2B': Name of the audience an offer is applicable to. (ALL, B2B) - `displayName` string: Localized display name for the audience. - `fulfillmentAvailability` FulfillmentAvailability[], nullable: The fulfillment availability for the listings item. - `fulfillmentChannelCode` string: Designates which fulfillment network is used. - `quantity` integer: The quantity of the item available for sale. - `procurement` Procurement[], nullable: The vendor procurement information for the listings item. - `costPrice` CurrencyAmount: The currency type and amount. - `currencyCode` string: Three-digit currency code in ISO 4217 format. - `amount` string: A decimal number with no loss of precision. Follows RFC7159 for number representation. - `relationships` MarketplaceRelationship[], nullable: Relationships for a listing item, by marketplace (for example, variations). - `marketplaceId` string: Amazon marketplace identifier. - `relationships` ProductRelationship[]: Relationships for the listing item. - `childSkus` string[], nullable: Identifiers (SKUs) of the related items that are children of this listing item. - `parentSkus` string[], nullable: Identifiers (SKUs) of the related items that are parents of this listing item. - `variationTheme` VariationTheme: A variation theme that indicates the combination of listing item attributes that define the variation family. - `attributes` string[]: The names of the listing item attributes that are associated with the variation theme. - `theme` string: The variation theme. - `type` 'VARIATION' | 'PACKAGE_HIERARCHY': The type of relationship. (VARIATION, PACKAGE_HIERARCHY) - `productTypes` ProductTypeDefinition[], nullable: Product types for a listing item, by marketplace. - `marketplaceId` string: Amazon marketplace identifier. - `productType` string: The name of the product type that is submitted by the Selling Partner. ## Other responses - `402`: Payment Required - subscription expired or payment method required - `403`: Access denied - insufficient permissions, invalid API key, or the API request limit is used up (`public_api_key_limit`) - `422`: Business logic error - operation cannot be completed due to business rules - `429`: Too many requests - rate limit exceeded - `500`: Internal Error --- [API](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api.md) · [All operations](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/revisions/5b3ecdbcadb6?raw)