---
title: "Search listings items"
method: GET
path: "/api/v1/listings/items"
tags: ["Listings Items"]
---

# Search listings items

`GET /api/v1/listings/items`

## 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/listings/items`
- Auth: one of:
  - API key in query parameter `api_key`
  - API key in header `X-Api-Key`

Search listings items with various filters and pagination support. 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

- SearchListingsItemsResponse: The response object for searching listings items.
  - `numberOfResults` integer: The total number of selling partner listings items found for the search criteria (only results up to the page count limit is returned per request regardless of the number found). Note: The maximum number of items (SKUs) that can be returned and paged through is 1000.
  - `pagination` Pagination: Pagination tokens for multi-page responses.
    - `nextToken` string, nullable: A token that can be used to fetch the next page.
    - `previousToken` string, nullable: A token that can be used to fetch the previous page.
  - `items` ListingsItem[]: A list of listings items.
    - `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)