---
title: "Retrieve a partner"
method: GET
path: "/partners/{id}"
tags: ["Partners"]
---

# Retrieve a partner

`GET /partners/{id}`

Retrieves the authenticated user's public profile, enrollment date, partner verification timestamp, verification waitlist status, active direct business referral count, and default payout rates. Use me or the authenticated user's own user ID; other users are not accessible. Users who have not enrolled have a null joined_at. Retrieve referral URLs and promotion links from GET /partners/links.

## Response `200`

partner retrieved

- Partner
  - `joined_at` string, nullable, required — When the user joined the partner program, as an ISO 8601 timestamp. Null when they have not joined.
  - `payout_rates` PartnerPayoutTier[], required
    - `duration` PartnerPayoutDuration, required
      - `unit` 'day' | 'month', required — Unit of the earning window. Month means a calendar month; day means a day.
      - `value` integer, required — Number of units in the earning window.
    - `rates` PartnerPayoutRate[], required
      - `income_source` 'sales' | 'transfer' | 'card_interchange' | 'ad_spend', required — Income source that generates this percentage payout.
      - `percentage` number, required — Partner's default percentage for this tier and income source. For example, 30 means 30%.
    - `tier` 'first' | 'second', required — Referral tier: first for a directly referred business, or second for a business brought by a referred partner.
  - `referred_businesses_count` integer, required — Number of active first-tier business referrals attributed to the partner, excluding deleted businesses.
  - `user` UserSummary, required
    - `id` string, required — User ID, prefixed `user_`.
    - `name` string, nullable, required — Display name.
    - `profile_picture` UserProfilePicture, required
      - `url` string, required — Avatar image URL. Always present — a generated placeholder when the user set no picture.
    - `username` string, required — Public username.
  - `verification_waitlist_joined` boolean, required — Whether the user has a pending or approved personal entry on the Verified Partner waitlist.
  - `whop_partner_verified_at` string, nullable, required — When the user became a verified Whop Partner, as an ISO 8601 timestamp. `null` if not verified.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found

## Changes

> 61 revisions in range; 1 not diffed.

- **2026-09-17** `ef86d14ef691` — 4 info
  - the security scope `partner:basic:read` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `referral:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - added the required property `verification_waitlist_joined` to the response with the `200` status
  - added the required property `whop_partner_verified_at` to the response with the `200` status
- **2026-09-16** `ff3a76573563` — 2 info
  - the security scope `partner:basic:read` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `referral:basic:read` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-15** `c19acf2e2548` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/partners/:id/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/ef86d14ef691?raw)