Skip to main content
GET
/
api
/
v1
/
stats
/
wallets
/
statement
Get financial statement
curl --request GET \
  --url https://api.whop.com/api/v1/stats/wallets/statement \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "report_type": "balance_activity",
    "rows": [
      {
        "period": "2025-01-01",
        "grouping": "payments",
        "line_category": "payment_gross",
        "amount": 14550.35
      },
      {
        "period": "2025-01-01",
        "grouping": "refunds",
        "line_category": "payment_refund",
        "amount": -500
      }
    ],
    "total": 14050.35
  },
  "metadata": {
    "wallet_id": "ldgr_xxx",
    "report_type": "balance_activity",
    "from": "2025-01-01",
    "to": "2025-06-01",
    "group_by": "month",
    "currency": "usd"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.whop.com/llms.txt

Use this file to discover all available pages before exploring further.

Requires the company:balance:read permission. See Permissions.
This is the same data that powers the Reports page in the Whop dashboard. Choose a report_type to get different financial views of your wallet activity.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
account_id
string

Query a sub-account's wallet instead of the caller's own. Pass a biz_ or user_ tag. The caller must have company:balance:read permission on the target account.

Example:

"biz_abc123"

​
report_type
enum<string>
required

The type of financial statement to generate.

  • balance_activity — Cash inflows/outflows by category over time
  • income_statement — Income and expenses over time
  • balance_summary — Account balances at period end with beginning/ending totals
Available options:
balance_activity,
income_statement,
balance_summary
​
from
string<date>
required

Start date in ISO 8601 format.

Example:

"2025-01-01"

​
to
string<date>
required

End date in ISO 8601 format.

Example:

"2025-12-31"

​
group_by
enum<string>
default:month

Time bucket granularity.

Available options:
day,
week,
month
​
currency
string

Filter to rows denominated in this currency (e.g. usd).

Examples:

"usd"

"eur"

​
convert_currency
string

Convert all amounts to this currency using historical exchange rates. Currencies without available FX rates are excluded and listed in fx_excluded_currencies.

Examples:

"usd"

"eur"

Response

Financial statement with metadata.

​
data
object
​
metadata
object