---
title: "GET /api/v4.0/integrations/configurations/rewards/coupons"
method: GET
path: "/api/v4.0/integrations/configurations/rewards/coupons"
---

# GET /api/v4.0/integrations/configurations/rewards/coupons

`GET /api/v4.0/integrations/configurations/rewards/coupons`

## Request

- Base URL: `https://api.gameball.co`
- URL: `https://api.gameball.co/api/v4.0/integrations/configurations/rewards/coupons`
- Auth: API key in header `apikey`

Retrieve coupon system configuration settings for the loyalty program.

## Response `200`

Coupon settings retrieved successfully

- object
  - `enabled` boolean
  - `maximumCoupons` number
  - `couponTypes` string[]
  - `expirationSettings` object
    - `defaultExpiryDays` number
    - `maxExpiryDays` number

## Changes

- **2025-09-30** `788718651767`: 1 info
  - removed the non-success response with the status `400`
- **2025-09-10** `95e7f65e5afd`: 1 info
  - endpoint added
- **2025-09-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/configurations/rewards/coupons/get.md)

---

[API](https://skmtc.dev/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.dev/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gameballers/apis/gameball-api/revisions/57b08ba96257?raw)