List businesses
Every business you manage, with its status and your share. Not paginated: returns a plain array. The platform is always the caller’s own account; an owner or admin of it.
id in the AgentaOS-Account header.Platforms
SDK: businesses.list()
Authorizations
Your secret key, from app.agentaos.ai -> Settings -> Developers -> API Keys. The key's prefix is both its identity and its environment: sk_test_... (sandbox, free, no verification) or sk_live_... (real money, requires business verification). A missing or invalid key returns 401.
Response
Every business you manage.
Business UUID. Send it in AgentaOS-Account to act as the business.
The name buyers see.
ISO 3166-1 alpha-2.
Where the business stands. live = verified and with a payout account. changes_needed = we asked the business for a change.
test_only, in_review, changes_needed, on_hold, rejected, live Your own id: the platform that manages it.
Your share of its new sales, set in the dashboard: basis points of the price before VAT (1000 = 10%) plus a fixed amount in minor units.
true for another app of your own company: verified and priced with you, no share, no identity check of its own.
Your share of its live sales this month, per currency. feesDisplay is ready to show.
Who an open invitation is waiting on, or null.
The identity check is done: its own, or your company's for another app of your own company.