---
title: "List partner referral requests"
method: GET
path: "/partner_referral_requests"
tags: ["Partner Referral Requests"]
---

# List partner referral requests

`GET /partner_referral_requests`

Lists requests sent by an eligible partner and requests for accounts where the authenticated user currently holds the owner role. Enrolled, non-suspended partners can read their links without verification; reading their sent manual requests requires verification. Filters narrow that combined view. Use a Whop login session or an account API key with `partner:referral_request:read`. The key must have been created by the account's current owner. Account API keys return their owner's sent requests and incoming requests for the key's account.

## Query parameters

- `account_id` string
- `partner_id` string
- `status` 'pending' | 'accepted' | 'denied' | 'cancelled'
- `request_type` 'manual' | 'ownership_transfer' | 'link'
- `order` 'created_at'
- `direction` 'asc' | 'desc'
- `first` integer
- `after` string
- `last` integer
- `before` string

## Response `200`

Requests listed.

- object
  - `data` PartnerReferralRequest[], required
    - `account` AccountSummary, required
      - `id` string, required — Account ID, prefixed `biz_`.
      - `title` string, required — Account display name.
    - `code` string, nullable, required — Unique referral code, when assigned.
    - `created_at` string, required — When the request was created, as an ISO 8601 timestamp.
    - `id` string, required — Partner referral request ID, prefixed `prfr_`.
    - `max_redemptions` integer, nullable, required — Maximum permitted redemptions, when limited.
    - `partner` 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.
    - `request_type` 'manual' | 'ownership_transfer' | 'link', required — How the referral request was initiated.
    - `rewards` PartnerReferralReward[], required
      - `bot_qualification_type` 'sales' | 'ad_spend' | 'null', nullable, required — Activity that qualifies for this reward, when specified.
      - `id` string, required — Partner reward ID, prefixed `prwd_`.
      - `qualification_amount` Money, required
        - `amount` string, required — The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
        - `currency` string, required — Three-letter ISO 4217 currency code, lowercase.
        - `decimals` integer, required — How many decimal places the amount CARRIES — the precision the charge itself runs at.
        - `display_decimals` integer, required — How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
      - `recipient` 'business' | 'partner' | 'null', nullable, required — Reward recipient's role, or null for a fixed user who is not the requesting partner.
      - `recipient_id` string, nullable, required — Concrete recipient's user or business ID, or null until a business redeems the offer.
      - `reward_amount` Money, required
        - `amount` string, required — The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
        - `currency` string, required — Three-letter ISO 4217 currency code, lowercase.
        - `decimals` integer, required — How many decimal places the amount CARRIES — the precision the charge itself runs at.
        - `display_decimals` integer, required — How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
    - `status` 'pending' | 'accepted' | 'denied' | 'cancelled' | 'null', nullable, required — The approval state, or null for requests without an approval process.
    - `updated_at` string, required — When the request last changed, as an ISO 8601 timestamp.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden

## Changes

> 70 revisions in range; 1 not diffed.

- **2026-09-23** `140d015b9966` — 1 breaking, 1 warning, 2 info
  - removed the enum value `reward_link` from the `query` request parameter `request_type`
  - added the new `link` enum value to the `data/items/request_type` response property for the response status `200`
  - added the new enum value `link` to the `query` request parameter `request_type`
  - removed the `reward_link` enum value from the `data/items/request_type` response property for the response status `200`
- **2026-09-19** `d629b0d5d839` — 1 info
  - added the required property `data/items/rewards` to the response with the `200` status
- **2026-09-18** `355991ab86d5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/partner_referral_requests/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/7fcefabddb0a?raw)