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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API Partners

> Commencez sur whop.com/network. Un Partner est un utilisateur qui recommande des personnes et des entreprises à Whop.

Commencez sur [whop.com/network](https://whop.com/network). Un Partner est un utilisateur qui recommande des personnes et des entreprises à Whop. Le profil partenaire inclut l'inscription, le nombre de parrainages directs d'entreprises actives et les conditions de rémunération par défaut.

Récupérez votre profil avec `/partners/me`. Utilisez `/partner_referral_requests` pour créer et gérer des liens de parrainage et leurs récompenses. Vous pouvez également vous inscrire au programme partenaire, consulter les utilisateurs et entreprises parrainés, suivre vos gains et voir le classement des partenaires.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Récupérer un partenaire](https://docs.whop.com/fr/api-reference/partners/retrieve-a-partner.md) | GET `/partners/{id}` |
| [Lister les entreprises parrainées](https://docs.whop.com/fr/api-reference/partners/list-referred-businesses.md) | GET `/partners/businesses` |
| [Récupérer une entreprise parrainée](https://docs.whop.com/fr/api-reference/partners/retrieve-a-referred-business.md) | GET `/partners/businesses/{id}` |
| [Lister les gains d'une entreprise parrainée](https://docs.whop.com/fr/api-reference/partners/list-referred-business-earnings.md) | GET `/partners/businesses/{id}/earnings` |
| [Récupérer les conditions tarifaires qu'un partenaire peut proposer](https://docs.whop.com/fr/api-reference/partners/retrieve-the-fee-terms-a-partner-can-offer.md) | GET `/partners/fee_options` |
| [Récupérer le classement](https://docs.whop.com/fr/api-reference/partners/retrieve-the-leaderboard.md) | GET `/partners/leaderboard` |
| [S'inscrire en tant que partenaire Whop](https://docs.whop.com/fr/api-reference/partners/enroll-as-a-whop-partner.md) | POST `/partners` |
| [Accepter une offre CPA](https://docs.whop.com/fr/api-reference/partners/accept-a-cpa-offer.md) | POST `/partners/businesses/{id}/accept_commission_advance` |
| [Renvoyer une invitation au propriétaire](https://docs.whop.com/fr/api-reference/partners/resend-an-owner-invite.md) | POST `/partners/businesses/{id}/resend_invite` |
| [Enregistrer les projections CPA](https://docs.whop.com/fr/api-reference/partners/save-cpa-projections.md) | PATCH `/partners/businesses/{id}` |

## Attributs

**account\_id** `string | null` *required*

L'entreprise à laquelle correspondent ces `payout_rates`, préfixée par `biz_`, lorsque la requête
a envoyé `account_id`. `null` lorsque les taux sont ceux de l'appelant.

**certification\_complete** `boolean` *required*

Indique si l'utilisateur a terminé le cours de certification partenaire : chaque quiz visible
et chaque vérification des connaissances a un résultat de réussite ou, lorsque le cours n'en contient aucun, chaque
leçon visible est marquée comme terminée.

**joined\_at** `string | null` *required*

Date à laquelle l'utilisateur a rejoint le programme partenaire, sous forme d'horodatage ISO 8601. Null s'il
ne l'a pas rejoint.

**payout\_rates** `object[]` *required*

Pourcentages de rémunération par défaut regroupés par niveau de parrainage, avec une durée de gains par niveau. Ceux de l'entreprise lorsque la requête a envoyé `account_id`, sinon ceux de l'appelant. Les entreprises existantes peuvent avoir des conditions individuelles.

> [accordion] Propriétés
>
> **duration** `object` *required*
>
> Période par défaut pendant laquelle une nouvelle entreprise parrainée peut générer des commissions, mesurée à partir du début de son attribution. Il ne s'agit pas d'un délai de versement. Les conditions individuelles d'une entreprise peuvent différer.
>
> > [accordion] Propriétés
> >
> > **unit** `string` *required*
> >
> > Unité de la période de gains. Month correspond à un mois calendaire ; day correspond à un jour.
> >
> > Options disponibles : `day`, `month`
> >
> > **value** `integer` *required*
> >
> > Nombre d'unités dans la période de gains.
>
> **rates** `object[]` *required*
>
> Pourcentages de rémunération par défaut pour chaque source de revenus dans ce niveau de parrainage.
>
> > [accordion] Propriétés
> >
> > **income\_source** `string` *required*
> >
> > Source de revenus qui génère ce pourcentage de rémunération.
> >
> > Options disponibles : `sales`, `transfer`, `card_interchange`, `ad_spend`, `withdrawal`
> >
> > **percentage** `number` *required*
> >
> > Pourcentage par défaut du partenaire pour ce niveau et cette source de revenus. Par exemple, 30 signifie 30 %.
>
> **tier** `string` *required*
>
> Niveau de parrainage : first pour une entreprise parrainée directement, ou second pour une entreprise apportée par un partenaire parrainé.
>
> Options disponibles : `first`, `second`

**referred\_businesses\_count** `integer` *required*

Nombre de parrainages actifs d'entreprises de premier niveau attribués au partenaire,
hors entreprises supprimées.

**referring\_partner** `object | null` *required*

L'utilisateur qui a parrainé cet utilisateur. Obsolète : n'est plus renseigné. Toujours `null`. OBSOLÈTE : n'est plus renseigné. Toujours null.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de l'utilisateur, préfixé par `user_`.
>
> **name** `string | null` *required*
>
> Nom d'affichage.
>
> **profile\_picture** `object` *required*
>
> Conteneur de l'avatar. Son `url` est toujours présent, et correspond à une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
>
> > [accordion] Propriétés
> >
> > **url** `string` *required*
> >
> > URL de l'image de l'avatar. Toujours présente. Il s'agit d'une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
>
> **username** `string` *required*
>
> Nom d'utilisateur public.

**user** `object` *required*

Le profil public du partenaire authentifié.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de l'utilisateur, préfixé par `user_`.
>
> **name** `string | null` *required*
>
> Nom d'affichage.
>
> **profile\_picture** `object` *required*
>
> Conteneur de l'avatar. Son `url` est toujours présent, et correspond à une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
>
> > [accordion] Propriétés
> >
> > **url** `string` *required*
> >
> > URL de l'image de l'avatar. Toujours présente. Il s'agit d'une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
>
> **username** `string` *required*
>
> Nom d'utilisateur public.

**verification\_waitlist\_joined** `boolean` *required*

Indique si l'utilisateur a une inscription personnelle en attente ou approuvée sur la liste d'attente
des Verified Partners.

**whop\_partner\_verified\_at** `string | null` *required*

Date à laquelle l'utilisateur est devenu un Whop Partner vérifié, sous forme d'horodatage ISO 8601. `null`
s'il n'est pas vérifié.

```json Partner theme={null}
{
	"user": {
		"id": "user_9mHw2b4TkL8pQ",
		"username": "jane",
		"name": "Jane Chen",
		"profile_picture": {
			"url": "https://example.com/jane-avatar.png"
		}
	},
	"joined_at": "2026-09-01T12:00:00.000Z",
	"whop_partner_verified_at": null,
	"verification_waitlist_joined": false,
	"certification_complete": false,
	"referred_businesses_count": 12,
	"referring_partner": null,
	"account_id": null,
	"payout_rates": [
		{
			"tier": "first",
			"duration": {
				"unit": "month",
				"value": 600
			},
			"rates": [
				{
					"income_source": "sales",
					"percentage": 30
				},
				{
					"income_source": "transfer",
					"percentage": 30
				},
				{
					"income_source": "card_interchange",
					"percentage": 30
				},
				{
					"income_source": "ad_spend",
					"percentage": 1
				}
			]
		},
		{
			"tier": "second",
			"duration": {
				"unit": "month",
				"value": 600
			},
			"rates": [
				{
					"income_source": "sales",
					"percentage": 10
				},
				{
					"income_source": "transfer",
					"percentage": 10
				},
				{
					"income_source": "card_interchange",
					"percentage": 10
				},
				{
					"income_source": "ad_spend",
					"percentage": 0.5
				}
			]
		}
	]
}
```


## Related topics

- [API Partner Referral Requests](https://docs.whop.com/fr/api-reference/partner-referral-requests/partner-referral-request.md)
- [API Whop Partners](https://docs.whop.com/fr/developer/partners/overview.md)
- [Retrieve a Partner](https://docs.whop.com/fr/api-reference/partners/retrieve-a-partner.md)
