---
title: "List Products"
method: GET
path: "/products"
tags: ["Products"]
---

# List Products

`GET /products`

## Query parameters

- `marketplace` 'all' | 'amazon.com' | 'amazon.com.mx' | 'amazon.co.uk' | 'amazon.ca' | 'amazon.de' | 'amazon.es' | 'amazon.fr' | 'amazon.it' | 'amazon.nl' | 'walmart.com' | 'shopify.com', required — Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com). If "all" is specified then the scope is all marketplaces.
- `access` 'true' | 'false' — Whether or not to only return products for brands that you have an active partnership with
- `product_ids` string — Filter products by their primary ID
- `brand_ids` string — Filter products by the brand ID
- `limit` number — The maximum number of items to return
- `cursor` string — The cursor returned from the last request, if omitted the first page will be returned

## Response `200`

Success

- object
  - `products` object[], required
    - `primaryId` string, required
    - `ids` object[], required
      - `label` 'ASIN' | 'SKU' | 'GTIN' | 'Walmart Item ID' | 'Variant ID', required
      - `value` string, required
    - `title` string, required — The title of the product
    - `brandId` string, required — The ID of the brand the product is associated with
    - `brandName` string, required — The name of the brand the product is associated with
    - `image` string, required
    - `category` string, required
    - `price` object, required
      - `currency` string, required
      - `value` string, required
    - `commission` object, required
      - `sellerCommission` string, required
      - `marketplaceCommission` string, required
      - `totalCommission` string, required
    - `deal` object, nullable, required
      - `active` boolean, required
      - `type` 'DEAL' | 'CLIPPABLE_COUPON' | 'PROMO_CODE' | 'FLASH_DEAL', required
      - `discountPrice` number, required — The price of the product after the deal discount
      - `discountPercentage` number, required — The percentage discount of the product
      - `startDate` string, date-time, required — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
      - `endDate` string, date-time, required — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
      - `promoCode` string, nullable, required — The promo code for the deal (if applicable)
    - `availability` 'IN_STOCK' | 'OUT_OF_STOCK', required
    - `marketplace` 'amazon.com' | 'amazon.com.mx' | 'amazon.co.uk' | 'amazon.ca' | 'amazon.de' | 'amazon.es' | 'amazon.fr' | 'amazon.it' | 'amazon.nl' | 'walmart.com' | 'shopify.com', required — Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com).
    - `access` boolean, required
    - `rating` string, nullable, required — Current rating of the product
    - `ratingsTotal` number, nullable, required — Total number of ratings for this product
    - `platformEpc` string, nullable, required — Earnings-per-click for the product on Levanta, if available. Otherwise null.
  - `cursor` string, nullable, required — The cursor to use for the next request, if empty there are no more items to return

## Other responses

- `401` — Unauthorized
- `422` — Input Validation Failed

---

[API](https://skmtc.dev/levanta/apis/levanta-creator-api-v2.md) · [All operations](https://skmtc.dev/levanta/apis/levanta-creator-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/levanta/levanta-creator-api-v2/revisions/f5dfab95939b/schema)