Refunds

List Refunds

Changed on

Lists refunds the caller can read, newest first. Filter by payment, account, or buyer to narrow the results.

get/refunds

Request

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

Query parameters

account_idstring

Only refunds issued by this account, prefixed biz_.

payment_idstring

Only refunds of this payment, prefixed pay_.

user_idstring

Only refunds to this buyer, prefixed user_.

created_beforestring date-time

Only refunds requested before this ISO 8601 timestamp.

created_afterstring date-time

Only refunds requested after this ISO 8601 timestamp.

order'created_at'

The field to sort by.

direction'asc' | 'desc'

The sort direction.

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.

Response

refunds listed

Example response

{
  "data": [
    {
      "account_id": "biz_xxxxxxxxxxxxxx",
      "amount": {
        "amount": "-1234.56",
        "currency": "usd",
        "decimals": 2,
        "display_decimals": 2
      },
      "created_at": "2026-01-01T12:00:00.000Z",
      "failure_message": "Insufficient funds on the merchant balance.",
      "failure_reason": "insufficient_funds",
      "id": "rf_xxxxxxxxxxxxxx",
      "original_amount": {
        "amount": "-1234.56",
        "currency": "usd",
        "decimals": 2,
        "display_decimals": 2
      },
      "payment_id": "pay_xxxxxxxxxxxxxx",
      "provider": "stripe",
      "provider_created_at": "2026-01-01T12:00:00.000Z",
      "reason": "duplicate",
      "reference_status": "available",
      "reference_type": "acquirer_reference_number",
      "status": "failed",
      "updated_at": "2026-01-01T12:00:00.000Z"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

  • c1dceb26e505Revision changes
    • warning

      added the new dispute_alert enum value to the // response property for the response 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