WHwhop
Cashback Rules

List Cashback Rules

Changed on

Lists the cashback rules funded by the authenticated platform account, including scheduled, expired, and discarded rules. Requires an account-scoped credential with payout:transfer:read.

get/cashback_rules

Request

  • Base URL
    https://api.whop.com/api/v1
  • URL
    https://api.whop.com/api/v1/cashback_rules
  • Auth
    HTTP bearer

Query parameters

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

order'created_at'

Field to sort by. Defaults to created_at.

direction'asc' | 'desc'

Sort direction. Defaults to desc.

Response

cashback rules listed

Example response

{
  "data": [
    {
      "created_at": "2026-01-01T12:00:00.000Z",
      "description": "Cloud cashback",
      "expires_at": "2026-01-01T12:00:00.000Z",
      "funding_account_id": "biz_xxxxxxxxxxxxxx",
      "id": "cicbr_xxxxxxxxxxxxxx",
      "merchant_category_code": "7372",
      "merchant_name": "ACME CLOUD",
      "rate_bps": 500,
      "scoped_account_id": "biz_xxxxxxxxxxxxxx",
      "starts_at": "2026-01-01T12:00:00.000Z",
      "updated_at": "2026-01-01T12:00:00.000Z"
    }
  ]
}

Changes

  • 140d015b9966Revision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

  • ff3a76573563Revision changes
    • breaking

      for the query request parameter first, default value 20 was added

    • warning

      for the query request parameter first, the max was set to 100.00

    • warning

      for the query request parameter last, the max was set to 100.00