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

# 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

---

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