Sign in
Payouts

List Payouts

Lists an account's or user's payouts, newest first.

get/payouts

Query parameters

account_idstring

The owning account ID (a biz_ identifier). Provide this or user_id.

user_idstring

The owning user ID (a user_ identifier). Provide this or account_id.

currencystring

Optional currency code filter, for example usd.

status'requested' | 'in_review' | 'processing' | 'completed' | 'reversed' | 'canceled' | 'failed' | 'denied'

Filter to payouts whose status reads this word, matching exactly what this version displays — reversed finds settled payouts the bank later returned. Requires Api-Version-Date 2026-08-21 or later.

source'api' | 'dashboard' | 'automatic'

Filter by how the payout was created. Payouts created before source tracking or through internal tooling carry no source and never match.

payout_method_idstring

Filter to payouts sent to one saved payout method (a pytk_ identifier). An unknown id matches nothing.

created_beforestring date-time

Only payouts created before this ISO 8601 time (exclusive).

created_afterstring date-time

Only payouts created at or after this ISO 8601 time (inclusive).

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

payouts listed

Example response

{
  "data": [
    {
      "amount": "500.0",
      "created_at": "2026-07-29T18:22:00.000Z",
      "currency": "usd",
      "destination_amount": "461.7",
      "destination_currency": "eur",
      "estimated_arrival": "2026-08-03T00:00:00.000Z",
      "exchange_rate": 0.9234,
      "failure": {
        "code": "beneficiary_name_mismatch"
      },
      "fee_amount": "0.25",
      "fee_paid_by": "self",
      "id": "wdrl_xxxxxxxxxxxxx",
      "markup_fee": "0.0",
      "metadata": {
        "batch_id": "2026-08-18"
      },
      "net_amount": "49.75",
      "notes": "Detailing supplies restock",
      "object": "payout",
      "payer_name": "ACH Bank Deposit",
      "payout_method": {
        "nickname": "Business checking",
        "supported_payout_method": {
          "delivery_type": "bank_deposit",
          "icon_url": "https://cdn.whop.com/payouts/ach.png",
          "payer_name": "ACH Bank Deposit"
        }
      },
      "payout_request_id": "cofr_xxxxxxxxxxxxx",
      "source": "api",
      "speed": "standard",
      "statement_descriptor": "MYCOMPANY",
      "status": "in_review",
      "status_detail": "awaiting_provider_acceptance",
      "trace_code": "021000021234567"
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "has_next_page": true,
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes