---
title: "List discounts"
method: GET
path: "/api/ecommerce/v1/stores/{store_id}/discounts"
tags: ["Ecommerce: Discounts"]
---

# List discounts

`GET /api/ecommerce/v1/stores/{store_id}/discounts`

List a store's discounts. Filter by free text over code and name, or by disabled state.
Amounts for fixed discounts are integers in the smallest currency unit; percentage
discounts carry a whole-number value between 1 and 100.

## Path parameters

- `store_id` string, required

## Query parameters

- `q` string
- `is_disabled` 'true' | 'false'
- `page` integer

## Response `200`

Success response

- object
  - `data` EcommerceV1DiscountDiscountResource[] — Array of [`Ecommerce.V1.Discount.DiscountResource`](#model/ecommercev1discountdiscountresource)
    - `id` string — The discount ID, required by every other discount endpoint.
    - `code` string — The discount code customers enter at checkout.
    - `name` string, nullable — The discount name, or null.
    - `type` 'percentage' | 'fixed' | 'free_shipping', nullable — The discount type, or null.
    - `value` integer, nullable — The discount value, or null. Percentage is 1-100; fixed is in the smallest currency unit.
    - `allocation` 'total' | 'item', nullable — Whether the discount applies to the cart total or to each item, or null.
    - `is_disabled` boolean — Whether the discount is disabled.
    - `starts_at` string, date-time — When the discount becomes active.
    - `ends_at` string, date-time, nullable — When the discount expires, or null.
    - `usage_limit` integer, nullable — Maximum number of redemptions, or null for unlimited.
    - `usage_count` integer — Number of times the discount has been redeemed.
  - `meta` CommonSchemaPaginationMetaSchema
    - `current_page` integer
    - `per_page` integer
    - `total` integer

## Other responses

- `401` — Unauthenticated response
- `500` — Error response

## Changes

- **2026-08-20** `b94885e042b8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hostinger/apis/hostinger-api/changes/api/ecommerce/v1/stores/:store_id/discounts/get.md)

---

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