---
title: "Lists accounts managed by the current user."
method: GET
path: "/managed_accounts"
tags: ["Managed Accounts"]
---

# Lists accounts managed by the current user.

`GET /managed_accounts`

Lists the accounts managed by the current user. Users need to be explictly approved by Telnyx in order to become manager accounts.

## Query parameters

- `filter` object
  - `email` object
    - `contains` string — If present, email containing the given value will be returned. Matching is not case-sensitive. Requires at least three characters.
    - `eq` string — If present, only returns results with the <code>email</code> matching exactly the value given.
  - `organization_name` object
    - `contains` string — If present, only returns results with the <code>organization_name</code> containing the given value. Matching is not case-sensitive. Requires at least three characters.
    - `eq` string — If present, only returns results with the <code>organization_name</code> matching exactly the value given.
  - `status` object
    - `eq` 'all' | 'active' | 'enabled' | 'cancelled' | 'disabled' | 'blocked' — If present, only returns managed accounts with the <code>status</code> matching exactly the value given. Use <code>enabled</code> or <code>disabled</code> to filter accounts by whether they are currently able to use Telnyx services.
- `page` object
  - `number` integer — The page number to load
  - `size` integer — The size of the page
- `sort` 'created_at' | 'email'
- `include_cancelled_accounts` boolean

## Response `200`

Successful response with a list of managed accounts.

- object
  - `data` ManagedAccountMultiListing[]
    - `api_user` string, required — The manager account's email, which serves as the V1 API user identifier
    - `created_at` string, required — ISO 8601 formatted date indicating when the resource was created.
    - `email` string, email, required — The managed account's email.
    - `id` string, uuid, required — Uniquely identifies the managed account.
    - `managed_account_allow_custom_pricing` boolean — Boolean value that indicates if the managed account is able to have custom pricing set for it or not. If false, uses the pricing of the manager account. Defaults to false. There may be time lag between when the value is changed and pricing changes take effect.
    - `manager_account_id` string, required — The ID of the manager account associated with the managed account.
    - `organization_name` string — The organization the managed account is associated with.
    - `record_type` 'managed_account', required — Identifies the type of the resource.
    - `rollup_billing` boolean — Boolean value that indicates if the billing information and charges to the managed account "roll up" to the manager account. If true, the managed account will not have its own balance and will use the shared balance with the manager account. This value cannot be changed after account creation without going through Telnyx support as changes require manual updates to the account ledger. Defaults to false.
    - `updated_at` string, required — ISO 8601 formatted date indicating when the resource was updated.
  - `meta` PaginationMeta
    - `page_number` integer
    - `page_size` integer
    - `total_pages` integer
    - `total_results` integer

## Other responses

- `401` — Unauthenticated response. Happens when the current user cannot be authenticated.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)