business_type, industry_group, and industry_type fields. See Business Types & Industries for every valid value.
Endpoints
Attributes
Account ID, prefixed
biz_.Account holdings, each with USD value. Empty when
total_usd is null.Properties
Properties
Total amount held in native units, as a decimal string.
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.
Holding icon URL.
The holding’s display name
USD price per unit, or
null when no exchange rate is available.Holding display symbol, such as
USDT, cbBTC, or EUR.Holding USD value, or
null when no exchange rate is available.Account banner image URL.
Account business address used to calculate tax, with
line1, line2, city,
state, postal_code, and country. null when no address is set.High-level business category for the account.
Payment rails enabled for this account, each
active, inactive, or pending (onboarding or review in progress). Computed only on retrieve and me for callers with company:balance:read scope; null otherwise.Properties
Properties
Bank payins: debits, transfers, and local bank railsAvailable options:
active, inactive, pendingBuy-now-pay-later payins; requires approvalAvailable options:
active, inactive, pendingCard payins, including Apple Pay and Google PayAvailable options:
active, inactive, pendingDeposits by bank wire or ACH to the account’s virtual bank accountAvailable options:
active, inactive, pendingBalance top-ups by charging a stored payment methodAvailable options:
active, inactive, pendingIssuing Whop cards; requires card application approvalAvailable options:
active, inactive, pendingOn-chain deposits to the account’s crypto walletAvailable options:
active, inactive, pendingOn-chain payouts to a crypto walletAvailable options:
active, inactive, pendingInstant payouts to an eligible payout destinationAvailable options:
active, inactive, pendingStandard payouts to an external payout destinationAvailable options:
active, inactive, pendingTransfers to other accountsAvailable options:
active, inactive, pendingCountry where the account is located.
When the account was created, as an ISO 8601 timestamp.
Account promotional description.
Account owner email address.
Public account home page preferences.
Account industry group.
Specific industry vertical for the account.
Prefix used for account invoices.
LLC formation state for the account: a draft state with
payment_pending, or
the live filing state with registration progress, documents, and pending
signatures.Account logo image URL.
Arbitrary key/value metadata supplied at account creation.
Type of onboarding the account has completed.
Account Open Graph image URL.
Account Open Graph image variant.
Business type details when business_type is
other.Industry details when industry_type is
other.Parent account ID for connected accounts.
Payment health controls currently applied to the account. Computed only on
retrieve and me for callers with company:balance:read scope; null otherwise.Properties
Properties
Fee charged for each dispute alert in USD.
null when unavailable.Whether payment health controls explicitly disable financing. This is
independent of financing approval in
capabilities.accept_bnpl_payments.Additional processing fee percentage for high-risk processing. Currently
0
for all accounts.Additional days payments remain pending before becoming available.
Automatic refund settings for resolution center cases.
Properties
Properties
Maximum card-funded resolution center case amount automatically refunded in
USD.
null when automatic refunds are disabled for cards.Maximum financing-funded resolution center case amount automatically refunded
in USD.
null when automatic refunds are disabled for financing.Whether the account owner is prevented from changing these thresholds.
Maximum PayPal-funded resolution center case amount automatically refunded in USD.
null when automatic refunds are disabled for PayPal.Tax classification code applied by default to the account’s products, with
id, name, and product_type. null when no default is set.DEPRECATED: Use the
GET /accounts/\{account_id}/recommend_actions endpoint instead.Properties
Properties
The recommendation; new values may be added, so handle unknown actions gracefullyAvailable options:
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_financingCapabilities this would unlock, or empty
The URL the call-to-action links to
Button label
Supporting copy, or empty
Illustration icon URL, or
nullEstimated impact from 0-100, or
null when not rankedWhy this action was recommended, or
nullAlways optional — never blockingAvailable options:
optionalHeadline for the recommendation
Whether authorized users must enable two-factor authentication.
Actions the account owner must take to unblock capabilities like payouts and card spend, ordered by display priority. Computed only on
retrieve and me for callers with company:balance:read scope; null otherwise.Properties
Properties
What the holder must do; new values may be added, so handle unknown actions gracefullyAvailable options:
deposit_funds, submit_information_request, verify_identity, connect_fulfillment_trackerCapabilities gated until this is resolved
The URL the call-to-action links to, or null when there is no button
Button label, or empty when there is no button
Supporting copy, or empty
The URL of the action’s illustration icon, or null if it has none
required (act now) or pending (under review)Available options:
required, pendingHeadline for the action
Account public route identifier.
Whether Whop sends transactional emails to customers on behalf of this
account.
Whether the account appears in joined whops on other accounts.
Whether reviews are displayed on direct-to-consumer product pages.
Whether the account shows users in the user directory.
Account social links.
Properties
Properties
The ID of the social link
The optional display title for the social link
The social link URL
The social platform for this linkAvailable options:
x, instagram, facebook, tiktok, youtube, linkedin, twitch, website, customWhether the account can operate on Whop:
active or suspended. Computed
only on retrieve and me; null otherwise.Account store page display configuration.
Target audience for this account.
US state codes (of the 50 states plus
DC) where the account collects tax:
the full set when Whop remits (tax_remitted_by whop), the configured
subset when the account self-remits (self), and empty when neither. On
update, send the complete list to replace it (only allowed when self).Account tax/VAT registrations, each with
id, tax_id_type, and
tax_id_value. Empty when none are set.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.Account display name.
Account lifetime sales, normalized to USD. Computed only on
retrieve and
me for callers with stats:read scope; null otherwise.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.Whether the account uses its logo as the fallback Open Graph image.
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.Account