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

# Customers API overview

> Track customers referred by your affiliate partners. Create, update, and manage customer attribution for commission calculation.

Customers are the people referred by your affiliate partners. When a customer signs up or makes a purchase through a partner's referral link, they are attributed to that partner for commission tracking.

## Key concepts

* **Customer key**: A unique identifier you assign (e.g., account ID, email)
* **Partner attribution**: Links a customer to the partner who referred them
* **Tags**: Labels for segmenting and filtering customers

## Available endpoints

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

  <Card title="Get customer" icon="user" href="/api-reference/customers/get">
    Get a specific customer's details and tags
  </Card>

  <Card title="Create customer" icon="user-plus" href="/api-reference/customers/create">
    Register a customer and attribute them to a partner
  </Card>

  <Card title="Update customer" icon="pen" href="/api-reference/customers/update">
    Modify customer details or tags
  </Card>

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

  <Card title="Suspend / Approve" icon="circle-pause" href="/api-reference/customers/suspend">
    Temporarily pause or reactivate a customer
  </Card>
</CardGroup>

## Customer lifecycle

1. **Created**—customer signs up via referral link or is created via API.
2. **Active**—transactions generate commissions for the attributed partner.
3. **Suspended**—temporarily paused, transactions don't generate commissions.
4. **Deleted**—permanently removed along with transaction history.

<Note>
  For refer-a-friend programs, customer management uses different field names and additional endpoints. See the [refer-a-friend customers](/api-reference/refer-a-friend/customers) section.
</Note>