---
title: "List Accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List Accounts

`GET /accounts`

Lists accounts visible to the credential. User tokens return the user's business accounts; business account API keys return the requesting business account and its connected accounts.

## Query parameters

- `first` integer
- `after` string
- `last` integer
- `before` string
- `order` 'created_at'
- `direction` 'asc' | 'desc'

## Response `200`

accounts listed

- object
  - `data` Account[], required
    - `balances` AccountBalanceToken[], required
      - `balance` string, required — Total amount held in native units, as a decimal string.
      - `breakdown` object, required — Balance split into available, pending, and reserve amounts, as native-unit decimal strings. On-chain crypto is entirely available; good_funds and fiat cash can have pending or reserve portions.
      - `icon_url` string, nullable, required — Holding icon URL.
      - `name` string, required — The holding's display name
      - `price_usd` number, nullable, required — USD price per unit, or `null` when no exchange rate is available.
      - `symbol` string, required — Holding display symbol, such as `USDT`, `cbBTC`, or `EUR`.
      - `value_usd` string, nullable, required — Holding USD value, or `null` when no exchange rate is available.
    - `banner_image_url` string, nullable, required — Account banner image URL.
    - `business_address` object, nullable, required — Account business address used to calculate tax, with `line1`, `line2`, `city`, `state`, `postal_code`, and `country`. `null` when no address is set.
    - `business_type` string, nullable, required — High-level business category for the account. See the [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary) for valid values.
    - `capabilities` AccountCapabilities, required
      - `accept_bank_payments` 'active' | 'inactive' | 'pending', required — Bank payins: debits, transfers, and local bank rails
      - `accept_bnpl_payments` 'active' | 'inactive' | 'pending', required — Buy-now-pay-later payins; requires approval
      - `accept_card_payments` 'active' | 'inactive' | 'pending', required — Card payins, including Apple Pay and Google Pay
      - `bank_deposit` 'active' | 'inactive' | 'pending', required — Deposits by bank wire or ACH to the account's virtual bank account
      - `card_deposit` 'active' | 'inactive' | 'pending', required — Balance top-ups by charging a stored payment method
      - `card_issuing` 'active' | 'inactive' | 'pending', required — Issuing Whop cards; requires card application approval
      - `crypto_deposit` 'active' | 'inactive' | 'pending', required — On-chain deposits to the account's crypto wallet
      - `crypto_payout` 'active' | 'inactive' | 'pending', required — On-chain payouts to a crypto wallet
      - `instant_payout` 'active' | 'inactive' | 'pending', required — Instant payouts to an eligible payout destination
      - `run_ads` 'active' | 'inactive' | 'pending', required — Launching ad campaigns through Whop Ads. `inactive` while a requested ads services agreement is awaiting the account's signature.
      - `standard_payout` 'active' | 'inactive' | 'pending', required — Standard payouts to an external payout destination
      - `transfer` 'active' | 'inactive' | 'pending', required — Transfers to other accounts
    - `cards` AccountCards, required
      - `kind` 'individual' | 'business' | 'null', nullable, required — Whether the card application verifies a business (`business`, KYB) or a person (`individual`, consumer identity). `null` when the application is not yet linked to a verification.
    - `collect_vat_id` boolean, required — Whether checkout shows a VAT/tax ID field for buyers to optionally enter. Does not require a VAT ID to purchase.
    - `company_formation` AccountCompanyFormation, required
      - `documents` AccountCompanyFormationDocument[]
        - `id` string, required — Document ID, prefixed `file_`.
        - `name` string, required — Human-readable document name, such as `Articles of Organization`.
        - `type` string, required — Document category: `articles_of_organization`, `operating_agreement`, `ein_letter`, `signed_ss4`, `signed_form8821`, or `mail` for postal correspondence received on the company's behalf.
        - `url` string, required — CDN URL for downloading the document.
      - `ein_registered` boolean — Whether the company's EIN has been issued by the IRS. Present once `status` leaves `draft`.
      - `legal_name` string, nullable — Registered company name including the entity ending, for example `Acme, LLC`. Present once `status` leaves `draft`.
      - `signatures` AccountCompanyFormationSignatures
        - `form8821` AccountCompanyFormationSignatureRequest
          - `expires_at` string — When the signing URL expires, as an ISO 8601 timestamp. Present while `status` is `pending`.
          - `status` 'pending' | 'unknown', required — `pending` when a signing session is ready for the founder; `unknown` when the signature state could not be determined.
          - `url` string — Hosted signing URL where the founder completes the form. Present while `status` is `pending`.
        - `ss4` AccountCompanyFormationSignatureRequest
          - `expires_at` string — When the signing URL expires, as an ISO 8601 timestamp. Present while `status` is `pending`.
          - `status` 'pending' | 'unknown', required — `pending` when a signing session is ready for the founder; `unknown` when the signature state could not be determined.
          - `url` string — Hosted signing URL where the founder completes the form. Present while `status` is `pending`.
      - `state_registered` boolean — Whether the state formation filing is complete. Present once `status` leaves `draft`.
      - `status` 'draft' | 'processing' | 'filed' | 'rejected' | 'completed'
    - `country` string, nullable, required — Country where the account is located.
    - `created_at` string, required — When the account was created, as an ISO 8601 timestamp.
    - `description` string, nullable, required — Account promotional description.
    - `email` string, nullable, required — Account owner email address.
    - `home_preferences` string[], required
    - `id` string, required — Account ID, prefixed `biz_`.
    - `industry_group` string, nullable, required — Account industry group. See the [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary) for valid values.
    - `industry_type` string, nullable, required — Specific industry vertical for the account. See the [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary) for valid values.
    - `invoice_prefix` string, nullable, required — Prefix used for account invoices.
    - `logo_url` string, nullable, required — Account logo image URL.
    - `metadata` object, required — Arbitrary key/value metadata supplied at account creation.
    - `onboarding_type` string, nullable, required — Type of onboarding the account has completed.
    - `opengraph_image_url` string, nullable, required — Account Open Graph image URL.
    - `opengraph_image_variant` string, nullable, required — Account Open Graph image variant.
    - `other_business_description` string, nullable, required — Business type details when business_type is `other`.
    - `other_industry_description` string, nullable, required — Industry details when industry_type is `other`.
    - `parent_account_id` string, nullable, required — Parent account ID for connected accounts.
    - `payment_controls` AccountPaymentControls, required
      - `dispute_alert_auto_refund` AccountDisputeAlertAutoRefundControl, required
        - `locked` boolean, required — Whether the account owner is prevented from changing this threshold.
        - `threshold_usd` number, nullable, required — Maximum dispute alert amount automatically refunded in USD. `null` when automatic refunds are disabled.
      - `dispute_alert_fee_usd` number, nullable, required — Fee charged for each dispute alert in USD. `null` when unavailable.
      - `financing_disabled` boolean, required — Whether payment health controls explicitly disable financing. This is independent of financing approval in `capabilities.accept_bnpl_payments`.
      - `high_risk_processing_fee_percentage` number, required — Additional processing fee percentage for high-risk processing. Currently `0` for all accounts.
      - `pending_auto_topup_fee_percentage` number, required — Percentage fee charged when pending, not-yet-settled balance is advanced to fund the account's cards balance, where `2` means 2%. `0` when the account is exempt.
      - `pending_balance_delay_days` integer, required — Additional days payments remain pending before becoming available.
      - `reserve` AccountReserveControl, required
        - `hold_period_days` integer, required — Number of days reserved funds are held before release.
        - `percentage` number, nullable, required — Percentage of incoming payment volume held in reserve. `null` when no reserve is applied.
      - `resolution_center_auto_refund` AccountResolutionCenterAutoRefundControl, required
        - `card_threshold_usd` number, nullable, required — Maximum card-funded resolution center case amount automatically refunded in USD. `null` when automatic refunds are disabled for cards.
        - `financing_threshold_usd` number, nullable, required — Maximum financing-funded resolution center case amount automatically refunded in USD. `null` when automatic refunds are disabled for financing.
        - `locked` boolean, required — Whether the account owner is prevented from changing these thresholds.
        - `paypal_threshold_usd` number, nullable, required — Maximum PayPal-funded resolution center case amount automatically refunded in USD. `null` when automatic refunds are disabled for PayPal.
    - `product_tax_code` object, nullable, required — Tax classification code applied by default to the account's products, with `id`, `name`, and `product_type`. `null` when no default is set.
    - `recommended_actions` AccountRecommendedAction[], nullable, required — DEPRECATED: Use the `GET /accounts/{account_id}/recommend_actions` endpoint instead.
      - `action` 'theme_business' | 'create_product' | 'create_plan' | 'verify_identity' | 'connect_affiliate_program' | 'create_promotion' | 'setup_tracking_pixel' | 'migrate_from_stripe' | 'accept_first_payment' | 'launch_first_ad' | 'launch_draft_campaign' | 'increase_ad_budget' | 'refresh_ad_creatives' | 'fix_ad_billing' | 'exclude_customers_from_ads' | 'retarget_abandoned_checkouts' | 'invite_team_member' | 'enable_tax_collection' | 'create_card' | 'join_whop_university' | 'apply_for_financing', required — The recommendation; new values may be added, so handle unknown actions gracefully
      - `blocked_capabilities` string[], required
      - `cta` string, required — The URL the call-to-action links to
      - `cta_label` string, required — Button label
      - `description` string, required — Supporting copy, or empty
      - `icon_url` string, nullable, required — Illustration icon URL, or `null`
      - `impact_score` integer, nullable, required — Estimated impact from 0-100, or `null` when not ranked
      - `reasoning` string, nullable, required — Why this action was recommended, or `null`
      - `status` 'optional', required — Always optional — never blocking
      - `title` string, required — Headline for the recommendation
    - `require_2fa` boolean, required — Whether authorized users must enable two-factor authentication.
    - `required_actions` AccountRequiredAction[], nullable, required
      - `action` 'deposit_funds' | 'submit_information_request' | 'verify_identity' | 'connect_fulfillment_tracker' | 'setup_apple_pay_domains', required — What the holder must do; new values may be added, so handle unknown actions gracefully
      - `blocked_capabilities` string[], required
      - `cta` string, nullable, required — The URL the call-to-action links to, or null when there is no button
      - `cta_label` string, required — Button label, or empty when there is no button
      - `description` string, required — Supporting copy, or empty
      - `icon_url` string, nullable, required — The URL of the action's illustration icon, or null if it has none
      - `status` 'required' | 'pending', required — required (act now) or pending (under review)
      - `title` string, required — Headline for the action
    - `route` string, required — Account public route identifier.
    - `send_customer_emails` boolean, required — Whether Whop sends transactional emails to customers on behalf of this account.
    - `show_joined_whops` boolean, required — Whether the account appears in joined whops on other accounts.
    - `show_reviews_dtc` boolean, required — Whether reviews are displayed on direct-to-consumer product pages.
    - `show_user_directory` boolean, required — Whether the account shows users in the user directory.
    - `social_links` AccountSocialLink[], required
      - `id` string, required — The ID of the social link
      - `title` string, nullable, required — The optional display title for the social link
      - `url` string, required — The social link URL
      - `website` 'x' | 'instagram' | 'facebook' | 'tiktok' | 'youtube' | 'linkedin' | 'twitch' | 'website' | 'custom', required — The social platform for this link
    - `status` string, nullable, required — Whether the account can operate on Whop: `active` or `suspended`. Computed only on `retrieve` and `me`; `null` otherwise.
    - `store_page_config` object, required — Account store page display configuration.
    - `target_audience` string, nullable, required — Target audience for this account.
    - `tax_collection_enabled_states` string[], required
    - `tax_identifiers` unknown[], required — Account tax/VAT registrations, each with `id`, `tax_id_type`, and `tax_id_value`. Empty when none are set.
      - unknown
    - `tax_remitted_by` string, nullable, required — Who calculates and remits tax for the account: `whop` (Whop calculates and remits), `self` (Whop calculates; the account collects and remits), or `none` (neither; the account is responsible). `null` until the account enrolls in the Whop tax service.
    - `tax_type` string, nullable, required — How tax is applied to the account's prices: `inclusive` (tax included in the listed price) or `exclusive` (tax added on top). Defaults to `exclusive` when unset; `null` only when the account has no payment connection.
    - `title` string, required — Account display name.
    - `total_earned_usd` number, nullable, required — Account lifetime sales, normalized to USD. Computed only on `retrieve` and `me` for callers with `stats:read` scope; `null` otherwise.
    - `total_usd` string, nullable, required — Total USD value across balances with known exchange rates. Computed only on single-account reads (`retrieve` and `me`); `null` on list responses, writes, missing balance-read permission, or unavailable balance source.
    - `use_logo_as_opengraph_image_fallback` boolean, required — Whether the account uses its logo as the fallback Open Graph image.
    - `verification` object, required — Account identity verification status for the `individual` (KYC) and `business` (KYB) profiles. Each is `null` until created, otherwise a `status` of `not_started`, `pending`, `approved`, or `rejected`.
    - `wallet` AccountWallet, required
      - `address` string, required — The on-chain address of the wallet
      - `id` string, required — Wallet ID, prefixed `wallet_`.
      - `network` 'solana' | 'ethereum' | 'bitcoin', required — The blockchain network the wallet lives on
  - `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

- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-07-26** `60bbb4a6ffbc` — 7 warning, 7 info
  - added the new `exclude_customers_from_ads` enum value to the `data/items/recommended_actions/items/action` response property for the response status `200`
  - added the new `fix_ad_billing` enum value to the `data/items/recommended_actions/items/action` response property for the response status `200`
  - added the new `increase_ad_budget` enum value to the `data/items/recommended_actions/items/action` response property for the response status `200`
  - added the new `launch_draft_campaign` enum value to the `data/items/recommended_actions/items/action` response property for the response status `200`
  - …10 more

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/accounts/get.md)

---

[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)