Partners - Whop Docs

Get started at whop.com/network. A Partner is a user who refers people and businesses to Whop. The partner profile includes enrollment, active direct business referral counts, and default payout terms. Retrieve your profile with /partners/{id}. Use /partner_referral_requests to create and manage referral links and their rewards. You can also enroll in the partner program, review referred users and businesses, track earnings, and see the partner leaderboard.

Endpoints

Endpoint	Request
Retrieve a partner	GET `/partners/{id}`
List referred businesses	GET `/partners/businesses`
Retrieve a referred business	GET `/partners/businesses/{id}`
List referred business earnings	GET `/partners/businesses/{id}/earnings`
Retrieve the leaderboard	GET `/partners/leaderboard`
List the users the caller referred	GET `/partners/referred_users`
Enroll as a Whop partner	POST `/partners`

Attributes

boolean

required

Whether the user finished the partner certification course: every visible quiz and knowledge check has a passing result, or, when the course has none, every visible lesson is marked completed.

string | null

required

When the user joined the partner program, as an ISO 8601 timestamp. Null when they have not joined.

object[]

required

Default payout percentages grouped by referral tier, with one earning duration per tier. Existing businesses can have individual terms.

Properties

object

required

Default period during which a new referred business can generate commissions, measured from its attribution start. This is not a payout delay. Individual business terms can differ.

Properties

string

required

Unit of the earning window. Month means a calendar month; day means a day.Available options: day, month

integer

required

Number of units in the earning window.

object[]

required

Default payout percentages for each income source in this referral tier.

Properties

string

required

Income source that generates this percentage payout.Available options: sales, transfer, card_interchange, ad_spend

number

required

Partner’s default percentage for this tier and income source. For example, 30 means 30%.

string

required

Referral tier: first for a directly referred business, or second for a business brought by a referred partner.Available options: first, second

integer

required

Number of active first-tier business referrals attributed to the partner, excluding deleted businesses.

object | null

required

The user currently attributed as this user’s primary referrer. Null when there is no active primary referral.

Properties

string

required

User ID, prefixed user_.

string | null

required

Display name.

object

required

Avatar wrapper; its url is always present, using a generated placeholder when the user set no picture.

Properties

string

required

Avatar image URL. Always present — a generated placeholder when the user set no picture.

string

required

Public username.

object

required

The authenticated partner’s public profile.

Properties

string

required

User ID, prefixed user_.

string | null

required

Display name.

object

required

Avatar wrapper; its url is always present, using a generated placeholder when the user set no picture.

Properties

string

required

Avatar image URL. Always present — a generated placeholder when the user set no picture.

string

required

Public username.

boolean

required

Whether the user has a pending or approved personal entry on the Verified Partner waitlist.

string | null

required

When the user became a verified Whop Partner, as an ISO 8601 timestamp. null if not verified.

Partner

{
	"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,
	"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
				}
			]
		}
	]
}

​Endpoints

​Attributes

Endpoints

Attributes