---
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; Account API keys return the requesting account and its connected accounts. Pass `parent_account_id` to return only that parent account's connected accounts.

## Query parameters

- `first` integer
- `after` string
- `last` integer
- `before` string
- `order` 'created_at' | 'volume'
- `direction` 'asc' | 'desc'
- `status` 'active' | 'suspended'
- `query` string
- `created_after` string, date-time
- `created_before` string, date-time
- `volume_min` number
- `volume_max` number
- `parent_account_id` string

## 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` AccountBalanceBreakdown, required
        - `available` string, required — Amount you can spend, send, or withdraw now, in native units, as a decimal string.
        - `in_transit` string, required — Amount moving between the account's own destinations, such as a treasury sweep to its crypto wallet or a card top-up. In native units, as a decimal string.
        - `pending` string, required — Amount from recent payments still settling, in native units, as a decimal string.
        - `pending_settlements` AccountBalanceSettlement[], required
          - `amount` string, required — Amount expected that day, in native units, as a decimal string.
          - `date` string, required — The day this money is expected to finish settling, as an ISO 8601 date.
        - `reserve` string, required — Amount held back, in native units, as a decimal string. Retrieve the account's reserves for why it is held and when it unlocks.
      - `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_name` string, nullable, required — The account's legal business name used with its tax address.
    - `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.
    - `can_transfer_pending_balance_to_children` boolean, required — Whether pending funds may be transferred from this platform account to its connected accounts.
    - `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.
      - `status` 'approved' | 'pending' | 'manual_review' | 'denied' | 'locked' | 'canceled' | 'needs_verification' | 'needs_information', required — Where the card application stands. `approved` means cards can be issued. `needs_verification` means the applicant has not completed identity verification yet; `needs_information` means they did, but the documents were rejected for a fixable reason and must be resubmitted. `pending` and `manual_review` are in flight. `denied`, `locked`, and `canceled` are terminal.
    - `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 only when the signing URL is included.
          - `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` and the caller has `incorporation:write`. Omitted from webhooks.
        - `ss4` AccountCompanyFormationSignatureRequest
          - `expires_at` string — When the signing URL expires, as an ISO 8601 timestamp. Present only when the signing URL is included.
          - `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` and the caller has `incorporation:write`. Omitted from webhooks.
      - `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.
    - `economic_intelligence` boolean, required — Whether economic intelligence is enabled for the account.
    - `email` string, nullable, required — Account owner email address.
    - `eula` File, required
      - `content_type` string, nullable, required — The file's MIME type, e.g. `application/pdf`.
      - `created_at` string, required — When the file was created, as an ISO 8601 timestamp.
      - `filename` string, nullable, required — The original filename, including its extension.
      - `id` string, required — The file's ID, prefixed `file_`.
      - `multipart_chunk_size` integer, nullable — The byte size each part (except the last) must be. Present only on create, and only for multipart uploads.
      - `multipart_upload_id` string, nullable — The ID of the multipart upload, passed back to `complete`. Present only on create, and only for multipart uploads.
      - `multipart_upload_urls` FileMultipartUrl[], nullable
        - `part_number` integer, required — The 1-based index of this part within the multipart upload.
        - `url` string, required — The presigned URL to PUT this part's bytes to.
      - `object` string, required — The type of this object, always `file`.
      - `size` integer, nullable, required — The file size in bytes. `null` until the upload has finished.
      - `upload_headers` object — Headers to send with the upload PUT. Present only on create.
      - `upload_status` 'pending' | 'processing' | 'ready' | 'failed', required — Where the file is in its upload lifecycle.
      - `upload_url` string, nullable — Presigned URL to PUT the file's bytes to. Present only on create, and only for single-part uploads.
      - `url` string, nullable, required — A URL to download the file: a permanent CDN URL for public files, a signed expiring URL for private ones. `null` until the upload has finished.
      - `visibility` 'public' | 'private', required — `public` files are served via an unsigned CDN URL; `private` files via a signed, expiring URL.
    - `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` 'platform' | 'seller' | 'null', nullable, required — Type of onboarding the account has completed.
    - `opengraph_image_url` string, nullable, required — Account Open Graph image URL.
    - `opengraph_image_variant` 'white' | 'black' | 'orange' | 'null', 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`.
    - `owner` UserSummary, required
      - `id` string, required — User ID, prefixed `user_`.
      - `name` string, nullable, required — Display name.
      - `profile_picture` UserProfilePicture, required
        - `url` string, required — Avatar image URL. Always present — a generated placeholder when the user set no picture.
      - `username` string, required — Public username.
    - `parent_account` AccountParent, required
      - `fees` object — Markup rates this parent charges the connected account being read, keyed by fee type (for example `crypto_deposit_markup`), each with `percentage_fee` and `fixed_fee_usd`. Resolved with the connected account's own overrides winning over the platform default.
      - `id` string, required — Account ID, prefixed `biz_`.
      - `logo_url` string, nullable, required — Account logo image URL.
      - `route` string, required — Account public route identifier.
      - `title` string, required — Account display name.
    - `partner` AccountPartner
      - `email` string, nullable, required — Email address for contacting the partner. Null when the partner has not added their own email address.
      - `id` string, required — User ID, prefixed `user_`.
      - `name` string, nullable, required — Display name.
      - `profile_picture` UserProfilePicture, required
        - `url` string, required — Avatar image URL. Always present — a generated placeholder when the user set no picture.
      - `username` string, required — Public username.
    - `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.
      - `enforce_3ds` boolean, required — Whether 3-D Secure is forced on every card payment at checkout. The account cannot bypass it while set.
      - `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.
      - `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.
      - `restricted_payment_methods` string[], required
      - `undated_pending_reason` 'kyc_incomplete' | 'pending_information_request' | 'withdrawals_disabled' | 'null', nullable, required — Why pending funds without a settlement date aren't moving yet. `kyc_incomplete` and `pending_information_request` are things the merchant can act on. `withdrawals_disabled` means Whop has blocked withdrawals, so these funds cannot become available. `null` when there's no reason to show — still clearing, or held for a reason that isn't named here.
      - `withdrawal_schedule` AccountWithdrawalScheduleControl, required
        - `day` integer, nullable, required — Day the automatic withdrawal runs on: 0-6 (Sunday-Saturday) for `weekly`, 1-31 for `monthly`. `null` for `manual` and `daily`.
        - `frequency` 'manual' | 'daily' | 'weekly' | 'monthly', required — How often the account's balance automatically withdraws.
        - `next_payout_date` string, nullable, required — Next date the automatic withdrawal is scheduled to run, as an ISO 8601 date. `null` for `manual` and `daily`, where no single next date applies.
    - `privacy_policy` File, required
      - `content_type` string, nullable, required — The file's MIME type, e.g. `application/pdf`.
      - `created_at` string, required — When the file was created, as an ISO 8601 timestamp.
      - `filename` string, nullable, required — The original filename, including its extension.
      - `id` string, required — The file's ID, prefixed `file_`.
      - `multipart_chunk_size` integer, nullable — The byte size each part (except the last) must be. Present only on create, and only for multipart uploads.
      - `multipart_upload_id` string, nullable — The ID of the multipart upload, passed back to `complete`. Present only on create, and only for multipart uploads.
      - `multipart_upload_urls` FileMultipartUrl[], nullable
        - `part_number` integer, required — The 1-based index of this part within the multipart upload.
        - `url` string, required — The presigned URL to PUT this part's bytes to.
      - `object` string, required — The type of this object, always `file`.
      - `size` integer, nullable, required — The file size in bytes. `null` until the upload has finished.
      - `upload_headers` object — Headers to send with the upload PUT. Present only on create.
      - `upload_status` 'pending' | 'processing' | 'ready' | 'failed', required — Where the file is in its upload lifecycle.
      - `upload_url` string, nullable — Presigned URL to PUT the file's bytes to. Present only on create, and only for single-part uploads.
      - `url` string, nullable, required — A URL to download the file: a permanent CDN URL for public files, a signed expiring URL for private ones. `null` until the upload has finished.
      - `visibility` 'public' | 'private', required — `public` files are served via an unsigned CDN URL; `private` files via a signed, expiring URL.
    - `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 /economic_intelligence?account_id={account_id}` endpoint instead.
      - `action` 'theme_business' | 'create_product' | 'create_plan' | 'verify_identity' | 'connect_affiliate_program' | 'create_promotion' | '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' | 'fix_funnel_dropoff' | 'invite_team_member' | 'enable_tax_collection' | 'create_card' | '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' | 'review_held_payments' | 'submit_information_request' | 'update_automatic_withdrawal_method' | 'reauthorize_payout_methods' | 'update_payout_profile' | 'card_usage_review' | 'verify_identity' | 'scale_account_setup' | 'sign_formation_documents' | 'connect_fulfillment_tracker' | 'setup_apple_pay_domains' | 'configure_tax_remitter' | 'add_vat_registration' | 'enable_two_factor_authentication', 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
    - `return_policy` File, required
      - `content_type` string, nullable, required — The file's MIME type, e.g. `application/pdf`.
      - `created_at` string, required — When the file was created, as an ISO 8601 timestamp.
      - `filename` string, nullable, required — The original filename, including its extension.
      - `id` string, required — The file's ID, prefixed `file_`.
      - `multipart_chunk_size` integer, nullable — The byte size each part (except the last) must be. Present only on create, and only for multipart uploads.
      - `multipart_upload_id` string, nullable — The ID of the multipart upload, passed back to `complete`. Present only on create, and only for multipart uploads.
      - `multipart_upload_urls` FileMultipartUrl[], nullable
        - `part_number` integer, required — The 1-based index of this part within the multipart upload.
        - `url` string, required — The presigned URL to PUT this part's bytes to.
      - `object` string, required — The type of this object, always `file`.
      - `size` integer, nullable, required — The file size in bytes. `null` until the upload has finished.
      - `upload_headers` object — Headers to send with the upload PUT. Present only on create.
      - `upload_status` 'pending' | 'processing' | 'ready' | 'failed', required — Where the file is in its upload lifecycle.
      - `upload_url` string, nullable — Presigned URL to PUT the file's bytes to. Present only on create, and only for single-part uploads.
      - `url` string, nullable, required — A URL to download the file: a permanent CDN URL for public files, a signed expiring URL for private ones. `null` until the upload has finished.
      - `visibility` 'public' | 'private', required — `public` files are served via an unsigned CDN URL; `private` files via a signed, expiring URL.
    - `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
    - `stablecoin_rails` boolean, required — Whether the account settles on stablecoin rails — its balance is held on-chain as USDT and paid out over crypto, rather than as fiat cash.
    - `status` string, nullable, required — Whether the account can operate on Whop: `active` or `suspended`. Computed on `list`, `retrieve`, `me`, and `suspend`; `null` otherwise.
    - `status_reason` string, nullable, required — Why the account was suspended, in language safe to show the account owner. Computed on `retrieve`, `me`, and `suspend`; `null` otherwise, when `status` is not `suspended`, and when the suspension was recorded without a reason.
    - `store_page_config` AccountStorePageConfig, required
      - `accent_color` 'ruby' | 'tomato' | 'red' | 'crimson' | 'pink' | 'plum' | 'purple' | 'violet' | 'iris' | 'cyan' | 'teal' | 'jade' | 'green' | 'grass' | 'brown' | 'blue' | 'orange' | 'indigo' | 'sky' | 'mint' | 'yellow' | 'amber' | 'lime' | 'lemon' | 'magenta' | 'gold' | 'bronze' | 'gray' | 'null', nullable, required — Accent color used on the account store page.
      - `layout` 'featured' | 'compact' | 'null', nullable, required — Layout used on the account store page.
      - `profile_variant` 'personal' | 'business' | 'null', nullable, required — Profile presentation used on the account store page.
      - `whop_affiliate_link` boolean, required — Whether the account store page shows a Whop affiliate link.
    - `target_audience` string, nullable, required — Target audience for this account.
    - `tax_collection_enabled_states` string[], required
    - `tax_identifiers` AccountTaxIdentifier[], required
      - `id` string, required — Tax identifier ID.
      - `tax_id_type` 'ad_nrt' | 'ao_tin' | 'ar_cuit' | 'al_tin' | 'am_tin' | 'aw_tin' | 'au_abn' | 'au_arn' | 'eu_vat' | 'az_tin' | 'bs_tin' | 'bh_vat' | 'bd_bin' | 'bb_tin' | 'by_tin' | 'bj_ifu' | 'bo_tin' | 'ba_tin' | 'br_cnpj' | 'br_cpf' | 'bg_uic' | 'bf_ifu' | 'kh_tin' | 'cm_niu' | 'ca_bn' | 'ca_gst_hst' | 'ca_pst_bc' | 'ca_pst_mb' | 'ca_pst_sk' | 'ca_qst' | 'cv_nif' | 'cl_tin' | 'cn_tin' | 'co_nit' | 'cd_nif' | 'cr_tin' | 'hr_oib' | 'do_rcn' | 'ec_ruc' | 'eg_tin' | 'sv_nit' | 'et_tin' | 'eu_oss_vat' | 'ge_vat' | 'gh_tin' | 'de_stn' | 'gb_vat' | 'gn_nif' | 'hk_br' | 'hu_tin' | 'is_vat' | 'in_gst' | 'id_npwp' | 'il_vat' | 'jp_cn' | 'jp_rn' | 'jp_trn' | 'kz_bin' | 'ke_pin' | 'kg_tin' | 'la_tin' | 'li_uid' | 'li_vat' | 'my_frp' | 'my_itn' | 'my_sst' | 'mr_nif' | 'mx_rfc' | 'md_vat' | 'me_pib' | 'ma_vat' | 'np_pan' | 'nz_gst' | 'ng_tin' | 'mk_vat' | 'no_vat' | 'no_voec' | 'om_vat' | 'pe_ruc' | 'ph_tin' | 'pl_nip' | 'ro_tin' | 'ru_inn' | 'ru_kpp' | 'sa_vat' | 'sn_ninea' | 'rs_pib' | 'sg_gst' | 'sg_uen' | 'si_tin' | 'za_vat' | 'kr_brn' | 'es_cif' | 'ch_uid' | 'ch_vat' | 'tw_vat' | 'tj_tin' | 'tz_vat' | 'th_vat' | 'tr_tin' | 'ug_tin' | 'ua_vat' | 'ae_trn' | 'us_ein' | 'uy_ruc' | 'uz_tin' | 'uz_vat' | 've_rif' | 'vn_tin' | 'zm_tin' | 'zw_tin' | 'sr_fin' | 'xi_vat', required — Tax ID type.
      - `tax_id_value` string, required — Tax ID value.
    - `tax_remitted_by` 'whop' | 'self' | 'none' | 'null', 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` 'inclusive' | 'exclusive' | 'null', 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.
    - `terms_of_service` File, required
      - `content_type` string, nullable, required — The file's MIME type, e.g. `application/pdf`.
      - `created_at` string, required — When the file was created, as an ISO 8601 timestamp.
      - `filename` string, nullable, required — The original filename, including its extension.
      - `id` string, required — The file's ID, prefixed `file_`.
      - `multipart_chunk_size` integer, nullable — The byte size each part (except the last) must be. Present only on create, and only for multipart uploads.
      - `multipart_upload_id` string, nullable — The ID of the multipart upload, passed back to `complete`. Present only on create, and only for multipart uploads.
      - `multipart_upload_urls` FileMultipartUrl[], nullable
        - `part_number` integer, required — The 1-based index of this part within the multipart upload.
        - `url` string, required — The presigned URL to PUT this part's bytes to.
      - `object` string, required — The type of this object, always `file`.
      - `size` integer, nullable, required — The file size in bytes. `null` until the upload has finished.
      - `upload_headers` object — Headers to send with the upload PUT. Present only on create.
      - `upload_status` 'pending' | 'processing' | 'ready' | 'failed', required — Where the file is in its upload lifecycle.
      - `upload_url` string, nullable — Presigned URL to PUT the file's bytes to. Present only on create, and only for single-part uploads.
      - `url` string, nullable, required — A URL to download the file: a permanent CDN URL for public files, a signed expiring URL for private ones. `null` until the upload has finished.
      - `visibility` 'public' | 'private', required — `public` files are served via an unsigned CDN URL; `private` files via a signed, expiring URL.
    - `three_ds_level` 'mandate_challenge' | 'mandate_if_required' | 'frictionless_if_required' | 'null', nullable, required — 3D Secure behavior for supported on-session card payments. `mandate_challenge` requires a 3DS challenge before payment processing; `mandate_if_required` mandates a challenge only when the payment processor requires it; `frictionless_if_required` uses the regular frictionless 3DS flow. Payments of $1,000 or more use `mandate_if_required` unless `mandate_challenge` is selected. Risk and authentication recovery requirements can override the preference. `null` uses the standard checkout flow.
    - `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`, `manual_review`, `approved`, or `rejected`.
    - `volume_usd` number, nullable, required — Lifetime volume through the account — sales plus transfers received — normalized to USD. Computed only on `list` for callers with `stats:read` on the account; `null` otherwise.
    - `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
    - `website` string, nullable, required — The account's business website URL, or `null` if none has been provided. Setting it also adds a `website` entry to `social_links`.
  - `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

## Changes

> 67 revisions in range; 1 not diffed.

- **2026-09-21** `ac2b9b1c6a00` — 1 warning, 3 info
  - added the new `scale_account_setup` enum value to the `data/items/required_actions/items/action` response property for the response status `200`
  - the security scope `company:balance:read` was removed from the endpoint's security scheme `bearerAuth`
  - removed the `accept_airwallex_terms` enum value from the `data/items/required_actions/items/action` response property for the response status `200`
  - removed the `verify_airwallex_account` enum value from the `data/items/required_actions/items/action` response property for the response status `200`
- **2026-09-21** `a88353507eac` — 1 info
  - the security scope `company:balance:read` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-20** `51933d70d7f5` — 1 info
  - the security scope `company:balance:read` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-19** `d629b0d5d839` — 1 warning, 1 info
  - added the new `verify_airwallex_account` enum value to the `data/items/required_actions/items/action` response property for the response status `200`
  - the security scope `company:balance:read` was removed from the endpoint's security scheme `bearerAuth`
- …earlier changes not shown

[Full 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.dev/whop/apis/whop-api/revisions/ac2b9b1c6a00?raw)