Sign in
Partner Referral Requests

Decline a partner referral request

Denies a pending manual request as a current business owner. Repeating denial returns the denied request. Use a Whop login session or an account API key with partner:referral_request:decline. The key must have been created by the account's current owner. Account API keys can respond only to requests for the key's account.

post/partner_referral_requests/{id}/decline

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Response

Request resolved.

codestring nullable required

Unique referral code, when assigned.

created_atstring required

When the request was created, as an ISO 8601 timestamp.

idstring required

Partner referral request ID, prefixed prfr_.

max_redemptionsinteger nullable required

Maximum permitted redemptions, when limited.

request_type'manual' | 'ownership_transfer' | '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_atstring required

When the request last changed, as an ISO 8601 timestamp.

Example response

{
  "account": {
    "id": "biz_xxxxxxxxxxxxxx",
    "title": "Shine Time Auto Detailing"
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "id": "prfr_xxxxxxxxxxxxxx",
  "partner": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Dana Whitfield",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "danawhitfield"
  },
  "request_type": "manual",
  "rewards": [
    {
      "bot_qualification_type": "sales",
      "qualification_amount": {
        "amount": "-2.50",
        "currency": "usd",
        "decimals": 2,
        "display_decimals": 2
      },
      "recipient": "business",
      "reward_amount": {
        "amount": "-2.50",
        "currency": "usd",
        "decimals": 2,
        "display_decimals": 2
      }
    }
  ],
  "status": "accepted",
  "updated_at": "2026-01-01T12:00:00.000Z"
}

Changes