---
description: Graphql fields and variables for the coupon query
---

# coupon

The coupon record that can be applied to a subscription

**Scope required:** product:read

For a complete list of possible response fields see the [Coupon](../../api-reference/types/coupon) type.

```graphql
query coupon ($id: ID, $code: String) {
  coupon (id: $id, code: $code) {
    active
    couponCode
    createdAt
    currencyId
    description
    discountAmount
    discountPercentage
    id
    name
    planId
    redemptionEndDate
    redemptionsCount
    redemptionsMax
    updatedAt
  }
}
```

## Arguments

| Name | Type   | Description         |
| ---- | ------ | ------------------- |
| id   | ID     | ID or Code required |
| code | String | ID or Code required |

## Response

* [Coupon](../../api-reference/types/coupon)
