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

# Get Customer Coupons

`GET /customer/coupons`

Retrieves the details of coupons (issued, redeemed, expired) of a specific customer.

## Query parameters

- `mobile` string
- `email` string
- `external_id` string
- `id` integer
- `start_date` string, date
- `end_date` string, date
- `status` 'unredeemed' | 'redeemed' | 'expired' | 'active'
- `series_id` integer
- `store_id` string
- `order_by` 'created_date' | 'created_by' | 'valid_till'
- `sort_order` 'asc' | 'desc'
- `limit` integer

## Response `200`

200

- object
  - `response` object
    - `pagination` object
      - `limit` string
      - `offset` string
      - `total` integer
    - `status` object
      - `success` string
      - `code` integer
      - `message` string
    - `customers` object
      - `customer` object[]
        - `firstname` string
        - `lastname` string
        - `email` string
        - `external_id` unknown
        - `mobile` string
        - `id` string
        - `coupons` object
          - `coupon` object[]
            - `id` string
            - `series_id` string
            - `series_name` string
            - `redemption_count` integer
            - `created_date` string
            - `valid_till` string
            - `code` string
            - `transaction_number` unknown
            - `purpose` string
            - `custom_properties` object
              - …
            - `redemptions` object
        - `item_status` object
          - `success` string
          - `code` integer
          - `message` string

## 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)