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

## Other responses

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

## Changes

> 60 revisions in range; 1 not diffed.

- **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/ff3a76573563?raw)