---
title: "Get coupon references"
method: GET
path: "/stores/{storeId}/coupons/all"
tags: ["Coupon"]
---

# Get coupon references

`GET /stores/{storeId}/coupons/all`

## Request

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

Gets the coupons in the store as references.
Requires the `stores.coupons.view` permission.

## Path parameters

- `storeId` string, uuid, required

## Response `200`

The object was successfully returned.

- PublicCouponReferenceIEnumerableResponse: Represents a default generic response for API endpoints.
  - `success` boolean, required: Indicates whether the operation or response was successful.
  - `message` string, nullable: A descriptive message providing additional context or information about the response.
  - `code` string, nullable: The error code (if there was an error) to use when referencing the error
  - `data` PublicCouponReference[], nullable: Represents the data associated with a response.
    - `code` string, required: The case-sensitive code the customer will enter to redeem the coupon
    - `percentageDecrease` number, double, nullable: The percentage that should be subtracted from the total order cost when used
    - `amountDecrease` number, double, nullable: The static amount to be subtracted from the total order cost when used

## Other responses

- `401`: You are not authorized, check your API key and try again.
- `403`: You are not authorized to access this endpoint, you may be missing an API key scope or be requesting a privileged endpoint.
- `404`: One of the objects referenced by the ID given in the URL or form was not found, check the ID and try again.

---

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