---
title: "Changes to Get Customer Coupons"
method: GET
path: "/api/v4.0/integrations/customers/{customerId}/coupons"
---

# Changes to Get Customer Coupons

`GET /api/v4.0/integrations/customers/{customerId}/coupons`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 47 revisions.

- **2026-10-05** `d38ce863fa38`: 1 info
- **2026-02-01** `78ca8b5e8cfc`: 1 info
- **2025-12-17** `d43ca6bdac5a`: 3 info
- **2025-09-30** `788718651767`: 1 info
- **2025-09-16** `9982cd425d6b`: 12 warning, 8 info
- **2025-09-08** `74802d3d15e7`: 1 info
- **2025-09-02** `919eb7a392aa`: 1 breaking

## Changes

- **2026-10-05** `d38ce863fa38`: 1 info
  - added the optional property `coupons/items/isLocked` to the response with the `200` status
- **2026-02-01** `78ca8b5e8cfc`: 1 info
  - added the optional property `coupons/items/iconPath` to the response with the `200` status
- **2025-12-17** `d43ca6bdac5a`: 3 info
  - the endpoint scheme security `apiKey AND secretKey` was added to the API
  - the endpoint scheme security `apiKey` was removed from the API
  - the endpoint scheme security `secretKey` was removed from the API
- **2025-09-30** `788718651767`: 1 info
  - removed the non-success response with the status `404`
- **2025-09-16** `9982cd425d6b`: 12 warning, 8 info
  - added the new `Automation` enum value to the `coupons/items/target` response property for the response status `200`
  - added the new `Custom` enum value to the `coupons/items/type` response property for the response status `200`
  - added the new `Fixed Rate Discount` enum value to the `coupons/items/type` response property for the response status `200`
  - added the new `Free Product` enum value to the `coupons/items/type` response property for the response status `200`
  - added the new `Free Shipping` enum value to the `coupons/items/type` response property for the response status `200`
  - added the new `Online` enum value to the `coupons/items/target` response property for the response status `200`
  - added the new `POS` enum value to the `coupons/items/target` response property for the response status `200`
  - added the new `Percentage` enum value to the `coupons/items/type` response property for the response status `200`
  - added the new `Percentage-based Cashback` enum value to the `coupons/items/type` response property for the response status `200`
  - added the new `Percentage-based Fees Discount` enum value to the `coupons/items/type` response property for the response status `200`
  - added the new `Permanent` enum value to the `coupons/items/target` response property for the response status `200`
  - added the new `Reward` enum value to the `coupons/items/target` response property for the response status `200`
  - api operation id `getCustomerCoupons` was added
  - the endpoint scheme security `secretKey` was added to the API
  - added the non-success response with the status `404`
  - added the optional property `coupons/items/customerUsedCount` to the response with the `200` status
  - added the optional property `coupons/items/isAvailableToUse` to the response with the `200` status
  - added the optional property `coupons/items/limitPerCustomer` to the response with the `200` status
  - added the optional property `coupons/items/usageLimit` to the response with the `200` status
  - added the optional property `coupons/items/usedCount` to the response with the `200` status
- **2025-09-08** `74802d3d15e7`: 1 info
  - endpoint added
- **2025-09-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/gameballers/apis/gameball-api/docs/api/v4.0/integrations/customers/:customerId/coupons/get.md) - [API](https://skmtc.dev/gameballers/apis/gameball-api.md) - [Page](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/customers/:customerId/coupons/get)