Sign in
Ledgers

List Financial Activity

Returns an account's or user's activity feed: every movement of money in or out.

get/financial_activity

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.

include_owned_accountsboolean

When true, aggregates the authenticated user's personal ledger with the businesses they own (owner role with balance read) into one feed. Requires user_id to be the authenticated user; cannot be combined with account_id or the settlement-date filters. Each returned row includes the owning account.

include_resourceboolean

Whether to include the resource field in the response or not. Consider passing false if you need a fast response without as many rich details.

line_typesstring[]

Optional ledger line categories to include. Some categories (for example onchain_deposit, which covers inbound crypto deposits such as MoonPay onramps) are only returned when explicitly requested here.

[
  "onchain_deposit"
]
direction'money_in' | 'money_out'

Optional direction filter. money_in returns positive activity and money_out returns negative activity.

resource_idstring

Optional prefixed resource ID. Returns activity associated with that resource.

activity_idstring

Optional ledger activity ID (for example line_3). Returns at most that one activity.

exclude_internal_movementsboolean

Whether to exclude balance reservations and balanced movements between the account's own balances.

currencystring

Optional currency code filter, for example usd.

posted_afterstring date-time

Only include rows posted after this ISO 8601 timestamp.

posted_beforestring date-time

Only include rows posted before this ISO 8601 timestamp.

available_afterstring date

Only include balance credits and debits available on or after this YYYY-MM-DD date (UTC), distinct from posted_at. Requires currency.

available_beforestring date

Only include balance credits and debits available on or before this YYYY-MM-DD date (UTC). Set equal to available_after for a single day. Requires currency.

limitinteger

Maximum number of rows to return.

cursorstring

Cursor returned by the previous page.

Response

activities listed for a user

Example response

{
  "data": [
    {
      "account": {
        "id": "biz_xxxxxxxxxxxxxx",
        "logo_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/shine-time-logo",
        "object": "account",
        "route": "biz_xxxxxxxxxxxxxx",
        "title": "Shine Time Auto Detailing"
      },
      "amount": "2375000000",
      "available_at": "2026-01-01T12:00:00.000Z",
      "currency": {
        "code": "usd",
        "precision": "100000000"
      },
      "id": "line_3",
      "ledger_account_id": "ldgr_xxxxxxxxxxxxxx",
      "line_type": "payment_gross",
      "object": "ledger_activity",
      "payment": {
        "amount": {
          "amount": "-2.50",
          "currency": "usd",
          "decimals": 2,
          "display_decimals": 2
        },
        "object": "payment"
      },
      "posted_at": "2026-01-01T12:00:00.000Z",
      "resource": {
        "id": "biz_xxxxxxxxxxxxxx",
        "logo_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/shine-time-logo",
        "object": "account",
        "route": "biz_xxxxxxxxxxxxxx",
        "title": "Shine Time Auto Detailing"
      },
      "source": {
        "amount_float": 1500,
        "chain": "plasma",
        "claim_url": "https://whop.com/claim",
        "created_at": "2026-01-01T12:00:00.000Z",
        "estimated_arrival": "2026-01-01T12:00:00.000Z",
        "fee_kind": "swap",
        "from_amount": "502.51",
        "from_currency": "usdt",
        "id": "airdrp_xxxxxxxxxxxxxx",
        "object": "airdrop_link",
        "payer_name": "MassPay",
        "payment_amount": {
          "amount": "-2.50",
          "currency": "usd",
          "decimals": 2,
          "display_decimals": 2
        },
        "payout_destination": {
          "icon_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/ach-activity-icon",
          "payer_name": "ACH Bank Deposit"
        },
        "payout_token_nickname": "Ops checking",
        "reason": "bounty_payout",
        "sender_address": "0x8a4de51b9c37f2e6a0d1b8c94e5f7a2d3c6b0e19",
        "status": "fully_claimed",
        "to_amount": "500.0",
        "to_currency": "usd",
        "tx_hash": "0x5d84a1c7e2f9b036d48c5a7e1b9f2d6c3a8e0b4f7c1d9e5a2b6f8c0d3e7a1b52"
      },
      "usd_amount": "23.75"
    }
  ],
  "page_info": {
    "end_cursor": "cursor_2",
    "has_next_page": true,
    "start_cursor": "cursor_1"
  }
}

Changes

Changed in 11 of the 74 revisions of this API.425

  • 78e1ed7366cd2See the full diff
    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 73dd0533cd812See the full diff
    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 86b97292852d2See the full diff
    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • c1dceb26e50535See the full diff
    • ●

      added the new platform_credits_granted enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new platform_credits_payment enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new platform_credits_payment_refund enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    • ○

      added the enum value platform_credits_granted to the property items/ of the query request parameter line_types

      request-parameter-property-enum-value-added

    • ○

      added the enum value platform_credits_payment to the property items/ of the query request parameter line_types

      request-parameter-property-enum-value-added

    • ○

      added the enum value platform_credits_payment_refund to the property items/ of the query request parameter line_types

      request-parameter-property-enum-value-added

  • 7fcefabddb0a2See the full diff
    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 140d015b99662See the full diff
    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 35edb053220a2See the full diff
    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ac2b9b1c6a0013See the full diff
    • ●

      added the new partner_grant_reward enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    • ○

      added the enum value partner_grant_reward to the property items/ of the query request parameter line_types

      request-parameter-property-enum-value-added

  • a88353507eac2See the full diff
    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 51933d70d7f52See the full diff
    • ○

      the security scope company:balance:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope user:balance:read was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

Of the 74 revisions, 1 has no diff computed.