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

# GET /api/v4.0/integrations/configurations/coupon

`GET /api/v4.0/integrations/configurations/coupon`

This API call retrieves your coupon configurations, including details about how coupons are structured, authenticated, and mapped within Gameball.

## Response `200`

Coupon configurations retrieved successfully

- object
  - `url` string — The URL where the coupon configuration is applied.
  - `method` string — The HTTP method used for the coupon configuration process (e.g., POST, PUT or GET).
  - `queryParams` object[] — List of query parameters used in the request.
    - `key` string — The key used in the query parameter.
    - `value` string — The value of the query parameter.
  - `headers` object[] — List of headers used in the request.
    - `key` string — The header key.
    - `value` string — The header value.
  - `payload` string — The request payload format or template.
  - `couponMapping` object — A dictionary mapping coupon types to specific keys in your system.
    - `fixed` string — The internal naming for the fixed discount codes in your system.
    - `percentage` string — The internal naming for the percentage discount codes in your system.
    - `freeProduct` string — The internal naming for the free product discount codes in your system.
    - `freeShipping` string — The internal naming for the free shipping discount codes in your system.
  - `enableFreeProduct` boolean — Indicates whether free product coupons are enabled.
  - `enableFixedRate` boolean — Indicates whether fixed-rate discount coupons are enabled.
  - `enableFreeShipping` boolean — Indicates whether free shipping coupons are enabled.
  - `enablePercentage` boolean — Indicates whether percentage-based discount coupons are enabled.
  - `platforms` object[] — List of platforms for which the coupon configurations are applied.
    - `displayName` string — The display name of the platform.
    - `value` string — The internal value used for the platform.

---

[API](https://skmtc.net/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.net/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gameballers/gameball-api/versions/2e4a8bfe2291/schema)