---
title: "Get All Customer Coupons"
method: GET
path: "/customers/coupons"
---

# Get All Customer Coupons

`GET /customers/coupons`

## Query parameters

- `mobile` string
- `email` string
- `externalId` string
- `id` integer
- `status` 'REDEEMED' | 'UNREDEEMED' | 'ACTIVE' | 'EXPIRED' | 'ACTIVE_REDEEMED' | 'ACTIVE_UNREDEEMED' | 'EXPIRED_REDEEMED' | 'EXPIRED_UNREDEEMED' | 'REDEEMABLE'
- `coupon_code_case` ''

## Response `200`

200

- union
  - object
    - `entity` object
      - `pagination` object
        - `limit` string
        - `offset` string
        - `total` integer
      - `customers` object[]
        - `firstname` string
        - `lastname` string
        - `mobile` string
        - `id` integer
        - `coupons` object[]
          - `code` string
          - `seriesId` integer
          - `description` string
          - `validTill` string
          - `discountType` string
          - `discountValue` integer
          - `discountUpto` integer
          - `redemptionCount` integer
          - `redemptionsLeft` integer
          - `id` integer
          - `createdDate` string
          - `transactionNumber` string
          - `issuedAt` object
            - `code` string
            - `name` string
          - `customProperty` object[]
            - `name` string
            - `value` string
          - `redemptions` unknown[]
            - unknown
          - `reversedRedemptions` unknown[]
            - unknown
    - `warnings` unknown[]
      - unknown
    - `errors` unknown[]
      - unknown
    - `success` boolean
  - object
    - `entity` object
      - `pagination` object
        - `limit` string
        - `offset` string
        - `total` integer
      - `customers` object[]
        - `firstname` string
        - `lastname` string
        - `email` string
        - `mobile` string
        - `id` integer
        - `externalId` string
        - `coupons` object[]
          - `code` string
          - `seriesId` integer
          - `description` string
          - `validTill` string
          - `discountType` string
          - `discountValue` integer
          - `discountUpto` integer
          - `redemptionCount` integer
          - `redemptionsLeft` integer
          - `id` integer
          - `createdDate` string
          - `transactionNumber` string
          - `issuedAt` object
            - `code` string
            - `name` string
          - `redemptions` unknown[]
            - unknown
          - `reversedRedemptions` unknown[]
            - unknown
    - `warnings` unknown[]
      - unknown
    - `errors` unknown[]
      - unknown
    - `success` boolean

## Other responses

- `400` — 400

---

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