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

# Get Coupons

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

Retrieves the coupons.

## Request body

- object
  - `page` integer — Page number.
  - `perPage` integer — Items per page, 1-100. Must be at least 1. Must not be greater than 100.
  - `orderColumn` 'id' | 'code' | 'discount' | 'uses' | 'start_date' | 'expiration_date' | 'last_used_at' | 'total_saved' | 'revenue_attributed'
  - `orderDirection` 'asc' | 'desc'
  - `code` string — Filter by coupon code.
  - `ids` integer[] — Filter by coupon IDs.
  - `statuses` string[]
  - `type` 'percentage' | 'fixed'
  - `global` boolean — Only global (all-products) coupons.

## Response `200`

- object
  - `current_page` integer
  - `data` object[]
    - `id` integer
    - `shop_id` integer
    - `code` string
    - `global` boolean
    - `discount` string
    - `uses` integer
    - `max_uses` string
    - `max_uses_per_customer` string
    - `min_invoice_price` string
    - `allowed_emails` string
    - `disable_if_volume_discount` boolean
    - `type` string
    - `start_date` string
    - `expiration_date` string
    - `uses_count_mode` string
    - `last_used_at` string
    - `total_saved` string
    - `revenue_attributed` string
    - `items` unknown[]
      - unknown
  - `first_page_url` string
  - `from` integer
  - `last_page` integer
  - `last_page_url` string
  - `links` object[]
    - `url` string
    - `label` string
    - `active` boolean
  - `next_page_url` string
  - `path` string
  - `per_page` integer
  - `prev_page_url` string
  - `to` integer
  - `total` integer

---

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