---
title: "List businesses"
method: GET
path: "/gateway/businesses"
tags: ["Businesses"]
---

# List businesses

`GET /gateway/businesses`

## Request

- Base URL: `https://api.agentaos.ai/api/v1`
- URL: `https://api.agentaos.ai/api/v1/gateway/businesses`
- Auth: API key in header `x-api-key`

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.

## Response `200`

Every business you manage.

- Business[]
  - `id` string, uuid, required: Business UUID. Send it in `AgentaOS-Account` to act as the business.
  - `name` string, required: The name buyers see.
  - `country` string, nullable, required: ISO 3166-1 alpha-2.
  - `status` 'test_only' | 'in_review' | 'changes_needed' | 'on_hold' | 'rejected' | 'live', required: Where the business stands. `live` = verified. A bank account is needed before the first payout, not for this status. `changes_needed` = we asked the business for a change.
  - `platformOrgId` string, uuid, required: Your own id: the platform that manages it.
  - `createdAt` string, date-time, required
  - `platformFee` object, required: 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.
    - `bps` integer, required
    - `fixedMinor` integer, required
    - `fixedDisplay` string, required: The fixed part as money, in the currency of this month's fees, else euros: `€0.30`.
  - `sameLegalEntity` boolean, required: `true` for another app of your own company: verified and priced with you, no share, no identity check of its own.
  - `feesThisMonth` object[], required: Your share of its live sales this month, per currency. `feesDisplay` is ready to show.
    - `currency` string, required
    - `feesMinor` integer, required
    - `feesDisplay` string, required
  - `invitedEmail` string, nullable, required: Who an open invitation is waiting on, or null.
  - `identityVerified` boolean, required: The identity check is done: its own, or your company's for another app of your own company.

## Other responses

- `401`: Missing or invalid `x-api-key`.
- `403`: A business you do not manage, or an id that does not exist: the same answer for both, so the response never confirms an id. Also returned when the caller is not an owner or admin of the platform.

---

[API](https://skmtc.dev/agentaos/apis/agentaos-gateway-api.md) · [All operations](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/revisions/3a8ad3c6b965?raw)