---
title: "List Deals"
method: GET
path: "/deals"
tags: ["Deals"]
---

# List Deals

`GET /deals`

## 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.
- `brand_ids` string — Comma-delimited list of strings representing an array. Example: 1,2,3 equivalent to [1,2,3]
- `product_ids` string — Filter deals by the associated products' primary IDs. Example: 1234567890,1234567891
- `starts_before` string, date-time — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
- `starts_after` string, date-time — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
- `ends_before` string, date-time — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
- `ends_after` string, date-time — Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ
- `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
  - `deals` object[], required
    - `type` 'DEAL' | 'CLIPPABLE_COUPON' | 'PROMO_CODE' | 'FLASH_DEAL', required
    - `productIds` object[], required
      - `label` 'ASIN' | 'SKU' | 'GTIN' | 'Walmart Item ID' | 'Variant ID', required
      - `value` string, 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).
    - `title` string, required
    - `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
    - `currency` 'USD' | 'GBP' | 'CAD' | 'EUR' | 'MXN', required
    - `fullPrice` number, required — The full price of the product before the deal discount
    - `discountPrice` number, required — The price of the product after the deal discount
    - `discountPercentage` number, required — The percentage discount of the product
    - `verified` boolean, required — Whether the deal is verified by Levanta or seller-submitted.
    - `promoCode` string, nullable, required — The promo code for the deal (if applicable)
  - `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)