---
title: "Get patient coupons"
method: GET
path: "/api/appointments/coupons"
tags: ["appointments"]
---

# Get patient coupons

`GET /api/appointments/coupons`

Get all coupons for the current patient with redemption counts

## Response `200`

Successful Response

- PatientCouponsListResponse — Response model for list of patient coupons.
  - `coupons` ModelsSchemasAppointmentModelsPatientCouponResponse[], required — List of patient coupons
    - `coupon_id` string, required — Stripe coupon ID
    - `name` string, nullable — Coupon name
    - `amount_off` integer, nullable — Fixed amount off in cents
    - `percent_off` number, nullable — Percentage off
    - `currency` string, nullable — Currency for amount_off
    - `valid` boolean, required — Whether coupon is currently valid
    - `status` string, nullable — Coupon lifecycle status (active, pending, exhausted, expired, cancelled)
    - `redeem_by` integer, nullable — Unix timestamp when coupon expires
    - `times_redeemed` integer, required — Number of times this coupon has been used by the patient
    - `max_redemptions` integer, nullable — Maximum number of times this coupon can be used (null if unlimited)
    - `remaining_redemptions` integer, nullable — Number of times this coupon can still be used (null if unlimited)
    - `created_at` integer, nullable — Unix timestamp when coupon was created
    - `is_gift` boolean — Whether this coupon comes from a gift purchase
    - `call_included` boolean — Whether this coupon covers the call conoscitiva
    - `call_used` boolean — Whether the call conoscitiva has already been used on this coupon
  - `total` integer, required — Total number of coupons

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)