> ## 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.

# Promotion codes API overview

> Create and manage promotion codes that link coupons to specific partners for sales attribution.

Promotion codes are the actual codes customers enter at checkout. Each promotion code is linked to a coupon and a partner, so when a customer uses the code, the sale is attributed to the correct partner.

## Key concepts

* **Promotion code**: A code customers enter (e.g., `JOHN20`)
* **Coupon**: The parent discount rule that defines the discount amount
* **Partner link**: Each promotion code is tied to a specific partner

## Available endpoints

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

  <Card title="Get code" icon="tag" href="/api-reference/promotion-codes/get">
    Get a specific promotion code's details
  </Card>

  <Card title="Create code" icon="plus" href="/api-reference/promotion-codes/create">
    Create a new promotion code linked to a partner
  </Card>

  <Card title="Update code" icon="pen" href="/api-reference/promotion-codes/update">
    Modify a promotion code
  </Card>

  <Card title="Delete code" icon="trash" href="/api-reference/promotion-codes/delete">
    Remove a promotion code
  </Card>
</CardGroup>

## Relationship with coupons

```
Coupon (20% off)
├── Promotion code "JOHN20" → Partner: John
├── Promotion code "SARAH20" → Partner: Sarah
└── Promotion code "MIKE20" → Partner: Mike
```

Each partner can have their own promotion code under the same coupon. This way, you manage the discount once at the coupon level and create individual codes per partner.