---
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, partner certification completion, 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. Create and manage referral links through /partner_referral_requests.

## Response `200`

partner retrieved

- Partner
  - `certification_complete` 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.
  - `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

> 74 revisions in range; 1 not diffed.

- **2026-09-27** `78e1ed7366cd` — 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-26** `73dd0533cd81` — 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-25** `86b97292852d` — 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-25** `c1dceb26e505` — 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-24** `7fcefabddb0a` — 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`

[Full 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/78e1ed7366cd?raw)