---
title: "Get Quantity Deal"
method: GET
path: "/v1/shops/{shopId}/quantity-deals/{dealId}"
tags: ["Quantity Deals"]
---

# Get Quantity Deal

`GET /v1/shops/{shopId}/quantity-deals/{dealId}`

## Request

- Base URL: `https://api.sellauth.com`
- URL: `https://api.sellauth.com/v1/shops/{shopId}/quantity-deals/{dealId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sellauth/apis/sellauth-api/docs/v1/shops/:shopId/quantity-deals/:dealId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a specific quantity deal.

## Response `200`

- object
  - `id` integer
  - `shop_id` integer
  - `name` string
  - `product_id` integer
  - `variant_id` integer
  - `buy_quantity` integer
  - `discounted_quantity` integer
  - `percentage` string
  - `max_uses_per_cart` string, nullable
  - `priority` integer
  - `starts_at` string, nullable
  - `ends_at` string, nullable
  - `enabled` boolean
  - `created_at` string
  - `updated_at` string
  - `product` object
    - `id` integer
    - `name` string
  - `variant` object
    - `id` integer
    - `name` string

## Changes

- **2026-11-02** `ff0d59c98d7a`: 3 breaking
  - the response property `ends_at` became nullable for the status `200`
  - the response property `max_uses_per_cart` became nullable for the status `200`
  - the response property `starts_at` became nullable for the status `200`
- **2026-10-20** `000b5ef816e6`: 1 warning
  - removed the optional property `product/stock_count` from the response with the `200` status

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/quantity-deals/:dealId/get.md)

---

[API](https://skmtc.dev/sellauth/apis/sellauth-api.md) - [All operations](https://skmtc.dev/sellauth/apis/sellauth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sellauth/apis/sellauth-api/revisions/156a9aef5e98?raw)