Retrieve a business
One business you manage, the same shape as a row of the list. A business you do not manage and an id that does not exist get the same 403, so the response never confirms an id.
status and identityVerified to see where the business’s verification stands, or listen for account.updated.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.
Path Parameters
The business UUID.
Response
The business.
A business you manage: a client's business, or another app of your own company. Every field is camelCase on the wire.
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.