API ReferenceAccount

Get account

Account status and readiness. Check readiness.operational — if false, readiness.actions lists what’s needed. readiness.next is the highest-priority action.

Authentication

AuthorizationBearer

API key (lb_ prefix). Pass as: Authorization: Bearer lb_...

Response

Successful Response
idstring
Unique identifier
emailstring
Account email address
has_avatarboolean

true if avatar image exists. Upload via POST /v1/files, set via PUT /v1/account.

planstring

Current plan tier. Values: free (15% fee), growth (5% fee), scale (3% fee).

fee_ratestring

Transaction fee rate as decimal string. Determined by plan: free=0.15, growth=0.05, scale=0.03. Applied as platform fee on each order.

billing_statusstring

Subscription billing status. active = payments current. past_due = payment failed, service continues during grace period. unpaid = grace period expired, listings may be blocked.

notify_ordersboolean
Whether seller receives email alerts for new external orders
statsobject
Account aggregate statistics.
readinessobject

Account operational readiness. operational is true when the account can sell. If false, actions lists what’s needed with kind (api/human), resolve details, and next points to the highest-priority action.

created_atdatetime
Time at which the account was created
object"account"

Object type identifier. Always account.

display_namestring or null
Seller name shown on product pages.
biostring or null
Short seller bio shown on product pages.
currencystring or null

Account currency (ISO 4217, lowercase). Set automatically from Stripe Connect. Cannot be changed after connection.

ga_measurement_idstring or null

Google Analytics 4 Measurement ID (G-XXXXXXXXXX). Set via PUT /v1/account. Injected on all your product pages and thank-you pages

Errors

401
Unauthorized Error