--- title: "List Financial Activity" method: GET path: "/financial-activity" tags: ["Ledgers"] --- # List Financial Activity `GET /financial-activity` Returns a paginated activity feed for one account or user, derived from ledger lines with typed resource and source objects for presentation. Pass exactly one of `account_id` (a `biz_` identifier) or `user_id` (a `user_` identifier). Filter by line type, currency, posted timestamp, or settlement date to reconcile a specific window. Pass `include_owned_accounts=true` with your own `user_id` to aggregate your personal ledger and the businesses you own into one feed; each row then carries the owning `account`. ## Query parameters - `account_id` string - `user_id` string - `include_owned_accounts` boolean - `line_types` string[] - `currency` string - `posted_after` string, date-time - `posted_before` string, date-time - `available_after` string, date - `available_before` string, date - `limit` integer - `cursor` string ## Response `200` activities listed for a user - object - `data` LedgerActivity[], required - `account` union — The viewer account that owns this row's ledger. Present only when the response aggregates owned accounts (include_owned_accounts=true); omitted otherwise. - object - `id` string, required — Account ID. - `logo_url` string, nullable, required — Account logo URL. - `object` 'account', required - `route` string, nullable, required — Account route. - `title` string, nullable, required — Account display name. - object - `id` string, required — User ID. - `name` string, nullable, required — User display name. - `object` 'user', required - `profile_picture_url` string, nullable, required — User profile image URL. - `username` string, nullable, required — User's username. - `amount` string, required — Signed amount in the currency's smallest precision units. - `available_at` string, date-time, nullable, required — ISO 8601 timestamp these funds became (or are scheduled to become) withdrawable: the posted time for already-settled funds, or 00:00:00 UTC on the scheduled release date for pending funds. Present only on inflows entering the balance (payments, top-ups, incoming transfers/affiliate); null on withdrawals, refunds, disputes and on-chain rows. The available_after/before filters window on its UTC settlement date. - `created_at` string, date-time, nullable, required — When the activity record was created. - `currency` object, required — Currency for this ledger activity. - `code` string, required — Currency code. - `precision` string, required — Precision factor for the currency, for example `100000000` for USD. - `id` string, required — Ledger activity ID. - `ledger_account_id` string, nullable — The ledger account (a ldgr_ identifier) this row belongs to. Present only when the response aggregates owned accounts (include_owned_accounts=true); omitted otherwise. Pair it with `account` to scope drawers and dashboard links to the owning business. - `line_type` string, required — Type of ledger activity. - `object` 'ledger_activity', required - `posted_at` string, date-time, required — When the activity posted to the ledger. - `resource` union, required — Resource associated with this ledger activity. - object - `id` string, required — Account ID. - `logo_url` string, nullable, required — Account logo URL. - `object` 'account', required - `route` string, nullable, required — Account route. - `title` string, nullable, required — Account display name. - object - `id` string, required — User ID. - `name` string, nullable, required — User display name. - `object` 'user', required - `profile_picture_url` string, nullable, required — User profile image URL. - `username` string, nullable, required — User's username. - object - `id` string, required — Bounty ID. - `object` 'bounty', required - `status` string, required — Bounty lifecycle status. - `title` string, required — Bounty title. - object - `id` string, required — Ledger account ID. - `object` 'ledger_account', required - `owner` union, required - object - `id` string, required — Account ID. - `logo_url` string, nullable, required — Account logo URL. - `object` 'account', required - `route` string, nullable, required — Account route. - `title` string, nullable, required — Account display name. - object - `id` string, required — User ID. - `name` string, nullable, required — User display name. - `object` 'user', required - `profile_picture_url` string, nullable, required — User profile image URL. - `username` string, nullable, required — User's username. - object - `bank` object, nullable, required - `account_name` string, nullable, required — Bank account holder name. - `account_type` string, nullable, required — Bank account type. - `bank_name` string, nullable, required — Bank name. - `last4` string, nullable, required — Last four digits of the bank account. - `card` object, nullable, required - `brand` string, nullable, required — Card brand. - `exp_month` integer, nullable, required — Card expiration month. - `exp_year` integer, nullable, required — Card expiration year. - `last4` string, nullable, required — Last four digits of the card. - `email_identifier` string, nullable, required — Email identifier for email-based payment methods. - `gateway_type` string, nullable, required — Payment gateway type. - `id` string, required — Payment method ID. - `object` 'payment_method', required - `payment_method_type` string, nullable, required — Payment method type. - object - `account_reference` string, nullable, required — Masked account reference. - `destination_currency_code` string, nullable, required — Destination currency code. - `id` string, required — Payout method ID. - `institution_name` string, nullable, required — Payout institution name. - `nickname` string, nullable, required — Payout method nickname. - `object` 'payout_method', required - `provider` string, nullable, required — Payout provider. - object - `authorized_at` string, date-time, nullable, required — ISO 8601 timestamp the transaction was authorized. - `card_id` string, nullable, required — Identifier of the card that the transaction was charged to. - `cashback_usd` string, nullable, required — Cashback earned on this transaction as a USD decimal string. Zero for declined or ineligible transactions; null when cashback has not been computed yet. - `declined_reason` string, nullable, required — Reason the transaction was declined (when status is declined). - `id` string, required — Card transaction ID. - `local_amount` string, nullable, required — Amount the merchant charged in their local currency, as a decimal string. Pair with local_currency. - `local_currency` string, nullable, required — ISO 4217 currency code of the merchant-charged amount in local_amount. - `merchant_category` string, nullable, required — Merchant category. - `merchant_icon_url` string, nullable, required — Merchant icon URL. - `merchant_name` string, nullable, required — Merchant display name. - `object` 'card_transaction', required - `posted_at` string, date-time, nullable, required — ISO 8601 timestamp the transaction was settled by the card network. - `status` string, nullable, required — Current card transaction status. - `usd_amount` string, nullable, required — The processor-settled USD amount as a decimal string. The ledger's USDT leg is posted 1:1 from this value. - `source` object, nullable, required — Source of this ledger activity. - `amount_float` number, nullable — Withdrawal amount as a decimal number in the destination currency (withdrawal sources only; requires payout:withdrawal:read). - `chain` string, nullable — Chain the deposit landed on, for example plasma (onchain_transaction sources only). - `claim_url` string, nullable — Public claim URL for the airdrop link (airdrop_link sources only). - `created_at` string, date-time, nullable — Withdrawal creation time as an ISO 8601 timestamp (withdrawal sources only; requires payout:withdrawal:read). - `estimated_arrival` string, date-time, nullable — Estimated arrival as an ISO 8601 timestamp (withdrawal sources only; requires payout:withdrawal:read). - `from_amount` string, nullable — Amount converted out of from_currency as a decimal string (swap sources only). - `from_currency` string, nullable — Lowercase currency code converted from (swap sources only). - `id` string, required - `object` string, required - `payer_name` string, nullable — Name of the entity processing the payout (withdrawal sources only; requires payout:withdrawal:read). - `payout_destination` object, nullable — Payout destination display info (withdrawal sources only). - `icon_url` string, nullable - `payer_name` string, nullable - `payout_token_nickname` string, nullable — Saved payout destination nickname (withdrawal sources only). - `reason` string, nullable — Transfer reason on transfer sources, for example pool_top_up or bounty_return. - `sender_address` string, nullable — Sender wallet address or onramp provider identifier (onchain_transaction sources only). - `status` string, nullable — Lifecycle status. On withdrawal sources this is the withdrawal status (requires payout:withdrawal:read); on airdrop_link sources it is the claim-link status (ungated); on payment and top-up sources it is the friendly payment status such as succeeded/pending/failed (ungated). - `to_amount` string, nullable — Amount received in to_currency as a decimal string (swap sources only). - `to_currency` string, nullable — Lowercase currency code converted to (swap sources only). - `tx_hash` string, nullable — On-chain transaction hash (onchain_transaction and swap sources only). - `page_info` object, required - `end_cursor` string, nullable, required - `has_next_page` boolean, required - `has_previous_page` boolean, required - `start_cursor` string, nullable, required ## Other responses - `400` — Invalid Parameters - `401` — Unauthorized - `403` — Forbidden - `404` — Resource not found --- [API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/60bbb4a6ffbc/schema)