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

# Coupons API overview

> Create and manage discount coupons for coupon-based partner tracking. Link coupons to partners for commission attribution.

Coupons enable coupon-based tracking as an alternative or complement to referral links. When a customer uses a partner's coupon code, the sale is automatically attributed to that partner.

## Key concepts

* **Coupon**: A discount code linked to a partner
* **Promotion code**: A specific code customers enter at checkout (a coupon can have multiple promotion codes)
* **Coupon-based tracking**: Attributing sales to partners via discount codes instead of referral links

## Available endpoints

<CardGroup cols={2}>
  <Card title="List coupons" icon="list" href="/api-reference/coupons/list">
    Retrieve all coupons with pagination
  </Card>

  <Card title="Get coupon" icon="ticket" href="/api-reference/coupons/get">
    Get a specific coupon's details
  </Card>

  <Card title="Create coupon" icon="plus" href="/api-reference/coupons/create">
    Create a new coupon
  </Card>

  <Card title="Update coupon" icon="pen" href="/api-reference/coupons/update">
    Modify coupon settings
  </Card>

  <Card title="Delete coupon" icon="trash" href="/api-reference/coupons/delete">
    Remove a coupon
  </Card>
</CardGroup>

## How coupon tracking works

1. **Create coupon**—define discount amount and type.
2. **Create promotion codes**—generate codes linked to partners via the [Promotion codes API](/api-reference/promotion-codes/overview).
3. **Customer applies code**—at checkout in Stripe, Paddle, or other integrations.
4. **Sale attributed**—Partnero attributes the sale to the partner and calculates commission.

<Tip>
  Coupons work with Stripe, Paddle, WooCommerce, and Shopify integrations. See the [coupon tracking guide](/guides/tracking/coupon-tracking) for setup details.
</Tip>
