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

> Partner Referral Request, bir partnerin yönlendirme bağlantısı veya mevcut bir işletmenin yönlendireni olarak kaydedilme talebidir.

Bir atıf talebi, yalnızca işletmenin bir sahibi onu kabul ettiğinde geçerli olur.

Yönlendirme bağlantıları oluşturmak ve atıf talepleri göndermek için Partner Referral Requests API'yi kullanın. Ayrıca gönderdiğiniz veya aldığınız bağlantıları ve talepleri listeleyebilir, bekleyen bir talebi kabul edebilir, reddedebilir veya iptal edebilirsiniz.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [List partner referral requests](https://docs.whop.com/tr/api-reference/partner-referral-requests/list-partner-referral-requests.md) | GET `/partner_referral_requests` |
| [Retrieve a partner referral request](https://docs.whop.com/tr/api-reference/partner-referral-requests/retrieve-a-partner-referral-request.md) | GET `/partner_referral_requests/{id}` |
| [Create a partner referral request](https://docs.whop.com/tr/api-reference/partner-referral-requests/create-a-partner-referral-request.md) | POST `/partner_referral_requests` |
| [Accept a partner referral request](https://docs.whop.com/tr/api-reference/partner-referral-requests/accept-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/accept` |
| [Cancel a partner referral request](https://docs.whop.com/tr/api-reference/partner-referral-requests/cancel-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/cancel` |
| [Decline a partner referral request](https://docs.whop.com/tr/api-reference/partner-referral-requests/decline-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/decline` |

## Özellikler

**id** `string` *required*

`prfr_` önekli partner yönlendirme talebi kimliği.

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

Atanmışsa, talebi alan işletme.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `biz_` önekli hesap kimliği.
>
> **title** `string` *required*
>
> Hesabın görünen adı.

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

Bu yönlendirmenin oluşturulduğu partnerin `ausr_` önekli ekip üyeliği. Yönlendirme kişisel olduğunda `null`.

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

Atanmışsa, benzersiz yönlendirme kodu.

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

Talebin oluşturulma zamanı, ISO 8601 zaman damgası olarak.

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

Sınırlıysa, izin verilen maksimum kullanım sayısı.

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

Partnerin o işletmedeki rolü üye kaydında tutulduğunda, bu yönlendirmenin oluşturulduğu partnerin `mber_` önekli üye kaydı. Aksi halde `null`.

**partner** `object` *required*

Talep eden partnerin herkese açık profili.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `user_` önekli kullanıcı kimliği.
>
> **name** `string | null` *required*
>
> Görünen ad.
>
> **profile\_picture** `object` *required*
>
> Avatar sarmalayıcısı. `url` değeri her zaman bulunur ve kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.
>
> > [accordion] Özellikler
> >
> > **url** `string` *required*
> >
> > Avatar görsel URL'si. Her zaman bulunur. Kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.
>
> **username** `string` *required*
>
> Herkese açık kullanıcı adı.

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

Yönlendirme partnerin ekibine aitse, partnerin bu talebi adına gönderdiği işletme. Kişisel bir yönlendirme için `null`.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `biz_` önekli hesap kimliği.
>
> **title** `string` *required*
>
> Hesabın görünen adı.

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

Yönlendirme talebinin nasıl başlatıldığı.

Kullanılabilir seçenekler: `manual`, `ownership_transfer`, `link`

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

Bu talebin sunduğu ödüller.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `prwd_` önekli partner ödülü kimliği.
>
> **bot\_qualification\_type** `string | null` *required*
>
> Belirtilmişse, bu ödüle hak kazandıran etkinlik.
>
> Kullanılabilir seçenekler: `sales`, `ad_spend`
>
> **qualification\_amount** `object` *required*
>
> Ödülü kazanmak için gereken, hak kazandıran etkinliğin USD tutarı.
>
> > [accordion] Özellikler
> >
> > **amount** `string` *required*
> >
> > Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin `"10.00"` on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
> >
> > **currency** `string` *required*
> >
> > Küçük harfli, üç harfli ISO 4217 para birimi kodu.
> >
> > **decimals** `integer` *required*
> >
> > Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
> >
> > **display\_decimals** `integer` *required*
> >
> > Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
>
> **recipient** `string | null` *required*
>
> Ödül alıcısının rolü veya talep eden partner olmayan sabit bir kullanıcı için null.
>
> Kullanılabilir seçenekler: `business`, `partner`
>
> **recipient\_id** `string | null` *required*
>
> Somut alıcının kullanıcı veya işletme kimliği ya da bir işletme teklifi kullanana kadar null.
>
> **reward\_amount** `object` *required*
>
> Hak kazanıldıktan sonra verilen USD tutarı.
>
> > [accordion] Özellikler
> >
> > **amount** `string` *required*
> >
> > Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin `"10.00"` on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
> >
> > **currency** `string` *required*
> >
> > Küçük harfli, üç harfli ISO 4217 para birimi kodu.
> >
> > **decimals** `integer` *required*
> >
> > Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
> >
> > **display\_decimals** `integer` *required*
> >
> > Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

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

Onay durumu veya onay süreci olmayan talepler için null.

Kullanılabilir seçenekler: `pending`, `accepted`, `denied`, `cancelled`

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

Talebin son değiştiği zaman, ISO 8601 zaman damgası olarak.

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

Bir atıf talebinin gönderildiği kullanıcı. Kullanımdan kaldırıldı: kullanıcılara yönelik talepler sona erdi. Her zaman `null`. DEPRECATED: Artık doldurulmuyor. Her zaman null.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `user_` önekli kullanıcı kimliği.
>
> **name** `string | null` *required*
>
> Görünen ad.
>
> **profile\_picture** `object` *required*
>
> Avatar sarmalayıcısı. `url` değeri her zaman bulunur ve kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.
>
> > [accordion] Özellikler
> >
> > **url** `string` *required*
> >
> > Avatar görsel URL'si. Her zaman bulunur. Kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.
>
> **username** `string` *required*
>
> Herkese açık kullanıcı adı.

```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/tr/api-reference/partner-referral-requests/create-a-partner-referral-request.md)
- [Retrieve a Partner Referral Request](https://docs.whop.com/tr/api-reference/partner-referral-requests/retrieve-a-partner-referral-request.md)
- [List Partner Referral Requests](https://docs.whop.com/tr/api-reference/partner-referral-requests/list-partner-referral-requests.md)
