---
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. 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' | 'reward_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' | 'reward_link', required — How the referral request was initiated.
    - `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

> 63 revisions in range; 1 not diffed.

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