List refunds

Returns a paginated list of refunds, with optional filtering by payment, company, user, and creation date.

Required permissions:

• payment:basic:read

GET /refunds

JavaScript

JavaScript

import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const refundListResponse of client.refunds.list()) {
  console.log(refundListResponse.id);
}

200

{
  "data": [
    {
      "amount": 6.9,
      "created_at": "2023-12-01T05:00:00.401Z",
      "currency": "usd",
      "id": "rf_xxxxxxxxxxxxxxx",
      "payment": {
        "id": "pay_xxxxxxxxxxxxxx"
      },
      "provider": "stripe",
      "provider_created_at": "2023-12-01T05:00:00.401Z",
      "reference_status": "available",
      "reference_type": "acquirer_reference_number",
      "reference_value": "74850120752",
      "status": "pending"
    }
  ],
  "page_info": {
    "end_cursor": "<string>",
    "has_next_page": true,
    "has_previous_page": true,
    "start_cursor": "<string>"
  }
}

Authorizations

Authorization · string · header · required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Query Parameters

after · string

Returns the elements in the list that come after the specified cursor.

before · string

Returns the elements in the list that come before the specified cursor.

first · integer

Returns the first n elements from the list.

Example:

42

last · integer

Returns the last n elements from the list.

Example:

42

payment_id · string

Filter refunds to only those associated with this specific payment.

Example:

"pay_xxxxxxxxxxxxxx"

company_id · string

Filter refunds to only those belonging to this company.

Example:

"biz_xxxxxxxxxxxxxx"

user_id · string

Filter refunds to only those associated with this specific user.

Example:

"user_xxxxxxxxxxxxx"

direction · enum<string>

The sort direction for ordering results, either ascending or descending.

Available options: asc, desc

created_before · string<date-time>

Only return refunds created before this timestamp.

Example:

"2023-12-01T05:00:00.401Z"

created_after · string<date-time>

Only return refunds created after this timestamp.

Example:

"2023-12-01T05:00:00.401Z"

Response

200

application/json

A successful response

The connection type for Refund.

data · object[] · required

A list of nodes.

Show child attributes

page_info · object · required

Information to aid in pagination.

Show child attributes