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

# Partners API overview

> Manage affiliate partners who promote your product. Create, update, track performance, and handle payouts.

Partners are the people who promote your product in affiliate programs. They share referral links, refer customers, and earn commissions on sales.

## Key concepts

* **Partner**: Someone who promotes your product and earns commissions
* **Referral key**: A unique identifier used in referral links (stored in `partnero_partner` cookie)
* **Commission**: The reward a partner earns when their referred customer makes a purchase
* **Tags**: Labels for organizing and filtering partners

## Available endpoints

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

  <Card title="Get partner" icon="user" href="/api-reference/partners/get">
    Get a specific partner's details, stats, and commissions
  </Card>

  <Card title="Create partner" icon="user-plus" href="/api-reference/partners/create">
    Register a new partner in your program
  </Card>

  <Card title="Update partner" icon="pen" href="/api-reference/partners/update">
    Modify partner details, tags, or status
  </Card>

  <Card title="Delete partner" icon="trash" href="/api-reference/partners/delete">
    Permanently remove a partner
  </Card>

  <Card title="Archive / Restore" icon="box-archive" href="/api-reference/partners/archive">
    Soft-delete or reactivate a partner
  </Card>
</CardGroup>

## Partner lifecycle

1. **Created**—partner signs up or is created via API.
2. **Active**—partner shares referral links and earns commissions.
3. **Archived**—temporarily deactivated (reversible).
4. **Deleted**—permanently removed (irreversible).