---
title: "Get a subaccount"
method: GET
path: "/subaccounts/{subaccount_id}"
---

# Get a subaccount

`GET /subaccounts/{subaccount_id}`

Retrieves detailed metadata about a specific subaccount by ID.

## Path parameters

- `subaccount_id` string, required — Subaccount ID.

## Headers

- `Authorization` string, required

## Response `200`

200

- GetSubaccountResponse200
  - `status` string — Whether the request was successful.
  - `response` SubaccountsSubaccountIdGetResponsesContentApplicationJsonSchemaResponse
    - `subaccounts` SubaccountsSubaccountIdGetResponsesContentApplicationJsonSchemaResponseSubaccountsItems[]
      - `subaccount_id` string — Subaccount ID.
      - `agency_id` string
      - `name` string
      - `pricing_tiers` SubaccountsSubaccountIdGetResponsesContentApplicationJsonSchemaResponseSubaccountsItemsPricingTiersItems[]
        - `pricing_tier_id` string
      - `permissions` SubaccountsSubaccountIdGetResponsesContentApplicationJsonSchemaResponseSubaccountsItemsPermissions
        - `assistants` boolean — Whether this subaccount can create and manage agents.
        - `knowledge_base` boolean — Whether this subaccount can access and manage knowledge bases.
        - `actions` boolean — Whether this subaccount can create and manage actions.
        - `workflows` boolean — Whether this subaccount can create and manage workflows.
        - `contacts` boolean — Whether this subaccount can create and manage contacts.
        - `phone_numbers` boolean — Whether this subaccount can acquire and manage phone numbers.
        - `inbound` boolean — Whether this subaccount can create and manage inbound voice agents.
        - `outbound` boolean — Whether this subaccount can create and manage outbound voice agents.
        - `widget` boolean — Whether this subaccount can create and manage web widget agents.
        - `chat` boolean — Whether this subaccount can create and manage chat agents.
        - `logs` boolean — Whether this subaccount can access call, chat, API, and webhook logs.
        - `simulations` boolean — Whether this subaccount can access call simulations and evaluations.
        - `analytics` boolean — Whether this subaccount can view the analytics dashboard.
      - `subscription` SubaccountsSubaccountIdGetResponsesContentApplicationJsonSchemaResponseSubaccountsItemsSubscription
        - `stripe_subscription_id` string
        - `synthflow_price_id` string
      - `minutes_used` integer
      - `max_minutes` integer, nullable — The maximum number of minutes allocated to this subaccount. Null if no limit is set.
      - `members` SubaccountsSubaccountIdGetResponsesContentApplicationJsonSchemaResponseSubaccountsItemsMembersItems[]
        - `email` string
        - `status` string

## Other responses

- `400` — 400
- `401` — Missing or invalid API credentials.
- `500` — The request could not be completed. Read `detail.description` for the reason, then retry the same request.
- `502` — The upstream service returned a body this API could not read. Retry the same request.

## Changes

- **2026-09-02** `a0a428a2afbe` — 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `500`
  - added the non-success response with the status `502`
- **2026-08-22** `292b6010eb31` — 1 info
  - api tag `` removed

[Change history](https://skmtc.dev/synthflow/apis/platform-api/changes/subaccounts/:subaccount_id/get.md)

---

[API](https://skmtc.dev/synthflow/apis/platform-api.md) · [All operations](https://skmtc.dev/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/synthflow/platform-api/revisions/a0a428a2afbe/schema)