> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Coupon Management Overview

> Manage unique coupon lists, upload coupon codes, and generate usage reports within the MoEngage system.

The MoEngage Coupon Management API allows you to organize and distribute unique, single-use coupon codes at scale. Use these endpoints to automate the lifecycle of coupon lists—from creation and file uploads to activation, archival, and detailed usage reporting.

## Endpoints

The Coupon Management API is categorized into three functional areas:

### Coupon Lists (Metadata and Status)

* [Create a Coupon List](/api/coupon-lists/create-a-coupon-list): Defines a new category for unique codes.
* [Fetch All Coupon Lists](/api/coupon-lists/fetch-all-coupon-lists): Retrieves a list of active or archived coupon containers.
* [Fetch Coupon List Details](/api/coupon-lists/fetch-coupon-list-details): Retrieves real-time counts of available vs. total coupons.
* [Update a Coupon List](/api/coupon-lists/update-a-coupon-list): Modifies names, expiry dates, or alert settings.
* [Activate Coupon List](/api/coupon-lists/activate-coupon-list): Reactivates archived lists with a new expiry date.
* [Archive a Coupon List](/api/coupon-lists/archive-a-coupon-list): Transitions a list to inactive and deletes associated codes.

### Coupon Files (Inventory Management)

* [Upload Coupon File](/api/coupon-files/upload-a-coupon-file-to-the-coupon-list): Populates a list via a hosted file URL.
* [Fetch All Coupon Files](/api/coupon-files/fetch-all-coupon-files-from-coupon-list): Tracks the status of all uploaded batches.
* [Fetch a Coupon File](/api/coupon-files/fetch-a-coupon-file-from-coupon-list): Checks the processing status (e.g., PENDING) of a specific file.
* [Delete a Coupon File](/api/coupon-files/delete-a-coupon-file-from-the-coupon-list): Removes specific batches (useful for correcting upload errors).

### Reports

* [Generate Usage Report](/api/reports/generate-usage-report): Generates a detailed usage report for a specific coupon list, providing details on which user received which coupon.

## Postman Collections

We have made it easy for you to test the APIs. Click [here](https://www.postman.com/moengage-dev/api-docs/collection/y1e45ee/moengage-coupon-management) to view our official Postman collections.