> ## 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 Partner Referral Requests

> Une Partner Referral Request est le lien de parrainage d'un partenaire, ou une demande pour être reconnu comme parrain d'une entreprise existante.

Une demande d'attribution ne prend effet que lorsqu'un propriétaire de l'entreprise l'accepte.

Utilisez l'API Partner Referral Requests pour créer des liens de parrainage et envoyer des demandes d'attribution. Vous pouvez également lister les liens et demandes que vous avez envoyés ou reçus, et accepter, refuser ou annuler une demande en attente.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les demandes de parrainage partenaire](https://docs.whop.com/fr/api-reference/partner-referral-requests/list-partner-referral-requests.md) | GET `/partner_referral_requests` |
| [Récupérer une demande de parrainage partenaire](https://docs.whop.com/fr/api-reference/partner-referral-requests/retrieve-a-partner-referral-request.md) | GET `/partner_referral_requests/{id}` |
| [Créer une demande de parrainage partenaire](https://docs.whop.com/fr/api-reference/partner-referral-requests/create-a-partner-referral-request.md) | POST `/partner_referral_requests` |
| [Accepter une demande de parrainage partenaire](https://docs.whop.com/fr/api-reference/partner-referral-requests/accept-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/accept` |
| [Annuler une demande de parrainage partenaire](https://docs.whop.com/fr/api-reference/partner-referral-requests/cancel-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/cancel` |
| [Refuser une demande de parrainage partenaire](https://docs.whop.com/fr/api-reference/partner-referral-requests/decline-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/decline` |

## Attributs

**id** `string` *required*

ID de la demande de parrainage partenaire, préfixé par `prfr_`.

**account** `object | null` *required*

Entreprise qui reçoit la demande, lorsqu'une entreprise est assignée.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte, préfixé par `biz_`.
>
> **title** `string` *required*
>
> Nom d'affichage du compte.

**authorized\_user\_id** `string | null` *required*

L'appartenance à l'équipe du partenaire pour laquelle ce parrainage a été créé, préfixée par `ausr_`.
`null` lorsque le parrainage est personnel.

**code** `string | null` *required*

Code de parrainage unique, lorsqu'il est attribué.

**created\_at** `string` *required*

Date de création de la demande, sous forme d'horodatage ISO 8601.

**max\_redemptions** `integer | null` *required*

Nombre maximal d'utilisations autorisées, lorsqu'il est limité.

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

La fiche membre du partenaire pour laquelle ce parrainage a été créé, préfixée par `mber_`,
lorsque son rôle dans cette entreprise est rattaché à sa fiche membre. `null`
dans le cas contraire.

**partner** `object` *required*

Profil public du partenaire à l'origine de la demande.

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

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

Entreprise au nom de laquelle le partenaire a envoyé cette demande, lorsque le parrainage appartient à son équipe. `null` pour un parrainage personnel.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte, préfixé par `biz_`.
>
> **title** `string` *required*
>
> Nom d'affichage du compte.

**request\_type** `string` *required*

La manière dont la demande de parrainage a été initiée.

Options disponibles : `manual`, `ownership_transfer`, `link`

**rewards** `object[]` *required*

Récompenses proposées par cette demande.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de la récompense partenaire, préfixé par `prwd_`.
>
> **bot\_qualification\_type** `string | null` *required*
>
> Activité qui donne droit à cette récompense, lorsqu'elle est spécifiée.
>
> Options disponibles : `sales`, `ad_spend`
>
> **qualification\_amount** `object` *required*
>
> Montant en USD de l'activité éligible requis pour obtenir la récompense.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"`
> > correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Nombre de décimales que comporte le montant. Il s'agit de la précision avec laquelle
> > le paiement lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est facturé en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez cette valeur pour formater le nombre selon vos propres paramètres régionaux.
>
> **recipient** `string | null` *required*
>
> Rôle du bénéficiaire de la récompense, ou null pour un utilisateur fixe qui n'est pas le partenaire à l'origine de la demande.
>
> Options disponibles : `business`, `partner`
>
> **recipient\_id** `string | null` *required*
>
> ID de l'utilisateur ou de l'entreprise bénéficiaire concret, ou null jusqu'à ce qu'une entreprise utilise
> l'offre.
>
> **reward\_amount** `object` *required*
>
> Montant en USD accordé une fois les conditions remplies.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"`
> > correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Nombre de décimales que comporte le montant. Il s'agit de la précision avec laquelle
> > le paiement lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est facturé en centavos mais écrit en pesos entiers, donc les valeurs sont `2` et `0`. Utilisez cette valeur pour formater le nombre selon vos propres paramètres régionaux.

**status** `string | null` *required*

L'état d'approbation, ou null pour les demandes sans processus d'approbation.

Options disponibles : `pending`, `accepted`, `denied`, `cancelled`

**updated\_at** `string` *required*

Date de dernière modification de la demande, sous forme d'horodatage ISO 8601.

**user** `object | null` *required*

L'utilisateur auquel une demande d'attribution a été envoyée. Obsolète : les demandes adressées à un utilisateur ont pris fin. 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.

```json PartnerReferralRequest theme={null}
{
	"id": "prfr_xxxxxxxxxxxxxx",
	"request_type": "manual",
	"status": "accepted",
	"code": null,
	"max_redemptions": null,
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Shine Time Auto Detailing"
	},
	"referring_account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Whitfield Growth Partners"
	},
	"partner": {
		"id": "user_xxxxxxxxxxxxxx",
		"name": "Dana Whitfield",
		"username": "danawhitfield",
		"profile_picture": {
			"url": "https://ui-avatars.com/api/?name=Dana+Whitfield"
		}
	},
	"user": null,
	"rewards": [
		{
			"id": "prwd_xxxxxxxxxxxxxx",
			"recipient": "partner",
			"recipient_id": "user_xxxxxxxxxxxxxx",
			"bot_qualification_type": "sales",
			"qualification_amount": {
				"amount": "1000.00",
				"currency": "usd",
				"decimals": 2,
				"display_decimals": 2
			},
			"reward_amount": {
				"amount": "100.00",
				"currency": "usd",
				"decimals": 2,
				"display_decimals": 2
			}
		}
	],
	"created_at": "2026-09-10T09:00:00.000Z",
	"updated_at": "2026-09-11T17:20:00.000Z",
	"authorized_user_id": null,
	"member_id": null
}
```


## Related topics

- [Create a Partner Referral Request](https://docs.whop.com/fr/api-reference/partner-referral-requests/create-a-partner-referral-request.md)
- [Retrieve a Partner Referral Request](https://docs.whop.com/fr/api-reference/partner-referral-requests/retrieve-a-partner-referral-request.md)
- [List Partner Referral Requests](https://docs.whop.com/fr/api-reference/partner-referral-requests/list-partner-referral-requests.md)
