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

# Partner Referral Requests API

> Een Partner Referral Request is de doorverwijslink van een partner, of een verzoek om als doorverwijzer van een bestaand bedrijf te worden erkend.

Een attributieverzoek treedt pas in werking wanneer een eigenaar van het bedrijf het accepteert.

Gebruik de Partner Referral Requests API om doorverwijslinks aan te maken en attributieverzoeken te versturen. Je kunt ook de links en verzoeken opvragen die je hebt verstuurd of ontvangen, en een openstaand verzoek accepteren, afwijzen of annuleren.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Partner referral requests opvragen](https://docs.whop.com/nl/api-reference/partner-referral-requests/list-partner-referral-requests.md) | GET `/partner_referral_requests` |
| [Een partner referral request ophalen](https://docs.whop.com/nl/api-reference/partner-referral-requests/retrieve-a-partner-referral-request.md) | GET `/partner_referral_requests/{id}` |
| [Een partner referral request aanmaken](https://docs.whop.com/nl/api-reference/partner-referral-requests/create-a-partner-referral-request.md) | POST `/partner_referral_requests` |
| [Een partner referral request accepteren](https://docs.whop.com/nl/api-reference/partner-referral-requests/accept-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/accept` |
| [Een partner referral request annuleren](https://docs.whop.com/nl/api-reference/partner-referral-requests/cancel-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/cancel` |
| [Een partner referral request afwijzen](https://docs.whop.com/nl/api-reference/partner-referral-requests/decline-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/decline` |

## Attributen

**id** `string` *required*

Partner referral request-ID, met prefix `prfr_`.

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

Bedrijf dat het verzoek ontvangt, wanneer er een is toegewezen.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Account-ID, met prefix `biz_`.
>
> **title** `string` *required*
>
> Weergavenaam van het account.

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

Het teamlidmaatschap van de partner waarvoor deze doorverwijzing is aangemaakt, met prefix `ausr_`. `null` wanneer de doorverwijzing persoonlijk is.

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

Unieke doorverwijscode, wanneer toegewezen.

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

Wanneer het verzoek is aangemaakt, als ISO 8601-tijdstempel.

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

Maximaal toegestaan aantal inwisselingen, wanneer beperkt.

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

Het memberrecord van de partner waarvoor deze doorverwijzing is aangemaakt, met prefix `mber_`, wanneer de rol van de partner bij dat bedrijf op het memberrecord is vastgelegd. Anders `null`.

**partner** `object` *required*

Openbaar profiel van de partner die het verzoek doet.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> User-ID, met prefix `user_`.
>
> **name** `string | null` *required*
>
> Weergavenaam.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> **username** `string` *required*
>
> Openbare gebruikersnaam.

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

Bedrijf namens welke de partner dit verzoek heeft verstuurd, wanneer de doorverwijzing bij het team van de partner hoort. `null` voor een persoonlijke doorverwijzing.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Account-ID, met prefix `biz_`.
>
> **title** `string` *required*
>
> Weergavenaam van het account.

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

Hoe het doorverwijzingsverzoek is gestart.

Beschikbare opties: `manual`, `ownership_transfer`, `link`

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

Beloningen die door dit verzoek worden aangeboden.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Partner reward-ID, met prefix `prwd_`.
>
> **bot\_qualification\_type** `string | null` *required*
>
> Activiteit die in aanmerking komt voor deze beloning, wanneer opgegeven.
>
> Beschikbare opties: `sales`, `ad_spend`
>
> **qualification\_amount** `object` *required*
>
> USD-bedrag aan kwalificerende activiteit dat nodig is om de beloning te verdienen.
>
> > [accordion] Eigenschappen
> >
> > **amount** `string` *required*
> >
> > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> >
> > **currency** `string` *required*
> >
> > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> >
> > **decimals** `integer` *required*
> >
> > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
>
> **recipient** `string | null` *required*
>
> Rol van de ontvanger van de beloning, of null voor een vaste gebruiker die niet de aanvragende partner is.
>
> Beschikbare opties: `business`, `partner`
>
> **recipient\_id** `string | null` *required*
>
> User- of bedrijfs-ID van de concrete ontvanger, of null totdat een bedrijf het aanbod inwisselt.
>
> **reward\_amount** `object` *required*
>
> USD-bedrag dat na kwalificatie wordt toegekend.
>
> > [accordion] Eigenschappen
> >
> > **amount** `string` *required*
> >
> > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> >
> > **currency** `string` *required*
> >
> > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> >
> > **decimals** `integer` *required*
> >
> > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.

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

De goedkeuringsstatus, of null voor verzoeken zonder goedkeuringsproces.

Beschikbare opties: `pending`, `accepted`, `denied`, `cancelled`

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

Wanneer het verzoek voor het laatst is gewijzigd, als ISO 8601-tijdstempel.

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

De gebruiker naar wie een attributieverzoek is verstuurd. Verouderd: verzoeken aan een gebruiker zijn beëindigd. Altijd `null`. VEROUDERD: wordt niet meer gevuld. Altijd null.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> User-ID, met prefix `user_`.
>
> **name** `string | null` *required*
>
> Weergavenaam.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> **username** `string` *required*
>
> Openbare gebruikersnaam.

```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

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