---
title: "Get Coupon"
method: GET
path: "/v1/shops/{shopId}/coupons/{couponId}"
tags: ["Coupons"]
---

# Get Coupon

`GET /v1/shops/{shopId}/coupons/{couponId}`

## Request

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

Retrieves a specific coupon.

## Response `200`

- object
  - `id` integer
  - `code` string
  - `salt` string
  - `global` boolean
  - `discount` string
  - `uses` integer
  - `max_uses` string, nullable
  - `max_uses_per_customer` string, nullable
  - `min_invoice_price` string, nullable
  - `allowed_emails` string, nullable
  - `payment_method_ids` string, nullable
  - `disable_if_volume_discount` boolean
  - `disable_if_bundle_offer` boolean
  - `disable_if_quantity_deal` boolean
  - `disable_if_gateway_discount` boolean
  - `disable_if_affiliate_discount` boolean
  - `disable_if_reseller_discount` boolean
  - `uses_count_mode` string
  - `type` string
  - `start_date` string, nullable
  - `expiration_date` string, nullable
  - `shop_id` integer
  - `created_at` string
  - `updated_at` string
  - `applies_to_renewals` boolean
  - `items` unknown[]
    - unknown

## Changes

- **2026-11-02** `ff0d59c98d7a`: 7 breaking
  - the response property `allowed_emails` became nullable for the status `200`
  - the response property `expiration_date` became nullable for the status `200`
  - the response property `max_uses` became nullable for the status `200`
  - the response property `max_uses_per_customer` became nullable for the status `200`
  - …3 more
- **2026-10-13** `5cbdf10d05ab`: 1 info
  - added the optional property `disable_if_reseller_discount` to the response with the `200` status

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/coupons/:couponId/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/ff0d59c98d7a?raw)