# Track Coupons

### 1. Purpose

Use this page to:

* Track all coupons issued through the referral program
* Identify which referrer owns each coupon
* Monitor coupon usage and status
* Search and filter coupons for auditing and reporting

<figure><img src="/files/NbxQ0ySjN3hn45w8EM06" alt=""><figcaption></figcaption></figure>

***

### 2. Coupon Table

The coupon table provides a complete list of all generated referral coupons.

#### Key Fields

| Field             | Description                                            |
| ----------------- | ------------------------------------------------------ |
| **Coupon code**   | Unique discount or referral code                       |
| **Referrer**      | Customer who owns the coupon                           |
| **Description**   | Reward details (e.g. "$10 off", "20% discount")        |
| **Status**        | Current state of the coupon (Available, Used, Expired) |
| **Expiry date**   | Coupon expiration date or "No expiry"                  |
| **Used in order** | Order ID where the coupon was applied (if used)        |
| **Created at**    | Date and time the coupon was generated                 |

***

### 3. Coupon Status

Coupons can have the following statuses:

* **Available**\
  The coupon is active and can be used
* **Used**\
  The coupon has been applied to an order
* **Expired**\
  The coupon is no longer valid

***

### 4. Search and Filtering

#### Search

* Search coupons by **coupon code**
* Useful for quickly locating specific coupons

#### Filters

Use filters to refine the coupon list based on:

* Status (Available, Used, Expired)
* Referrer
* Creation date

***

### 5. Sorting

* Sort coupons by **Created at**
* Helps identify newest or oldest coupons

***

### 6. Notes

* Each coupon is linked to a specific **referrer**
* A coupon can only be used once unless configured in shopify admin
* Coupon usage is tied to order completion rules
* Expired coupons cannot be applied to new orders


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bloop.plus/referral-program/track-coupons.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.