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

# Affiliés

> Vos affiliés, leurs performances et leurs commissions.

Permission : `affiliates.read`. Guide : [Affiliés](https://docs.pulse-sell.com/guides/affiliates.md). Les chiffres ne concernent que les produits de la boutique de la clé ; l'adresse e-mail, le solde et les retraits d'un affilié ne sont jamais exposés.

## Lister les affiliés

`GET /affiliates` — `affiliates.read`

Les affiliés ayant au moins un lien vers un produit de la boutique, du plus récent au plus ancien.

| Paramètre | Description |
| - | - |
| `per_page`, `cursor` | [Pagination](https://docs.pulse-sell.com/concepts/pagination.md). |
| `status` | `active` ou `suspended` (`422` sinon). |

```bash cURL theme={null}
curl https://api.pulse-sell.com/v1/affiliates \
  -H "Authorization: Bearer $PULSESELL_API_KEY"
```

## Obtenir un affilié

`GET /affiliates/{id}` — `affiliates.read`

`{id}` accepte l'identifiant **ou le code de parrainage**. `404` si l'affilié n'a aucun lien vers vos produits.

```json Réponse theme={null}
{
  "data": {
    "id": "cm1aff001", "code": "AWA10", "status": "active", "name": "Awa", "country": "CI", "source": "network",
    "total_visits": 240, "total_sales": 12,
    "total_revenue": { "value": 240000, "currency": "XOF" },
    "total_earnings": { "value": 24000, "currency": "XOF" },
    "commission_rate": 0.1,
    "first_visit_at": "2026-09-02T09:00:00.000Z", "last_visit_at": "2026-10-29T14:00:00.000Z",
    "joined_at": "2026-09-01T10:00:00.000Z", "created_at": "2026-09-01T10:00:00.000Z"
  }
}
```

## Lister les commissions

`GET /affiliates/{id}/commissions` — `affiliates.read`

Commissions générées sur les produits de la boutique, de la plus récente à la plus ancienne. Paginées.

```json Réponse theme={null}
{
  "data": [
    { "id": "cm1com001", "affiliate_id": "cm1aff001", "order_id": "cm1sale001", "product_name": "Guide complet", "type": "product",
      "status": "pending", "order_amount": { "value": 20000, "currency": "XOF" }, "commission": { "value": 2000, "currency": "XOF" },
      "rate": 0.1, "paid_at": null, "created_at": "2026-10-29T16:17:10.000Z" }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.