---
title: "Pre-Release: Query managed accounts"
method: GET
path: "/public/v2/managed/accounts"
tags: ["Managed Accounts"]
---

# Pre-Release: Query managed accounts

`GET /public/v2/managed/accounts`

Required permission: Managed Account Information, View.<br/>Query managed accounts within your account hierarchy with filtering and pagination support.
Returns up to 100 accounts at at time.
            
This endpoint is available for select audiences only.

## Query parameters

- `ancestorAccountNumber` string
- `searchString` string
- `accountNumbers` string[]
- `maxDepth` integer
- `cursor` string

## Response `200`

Managed accounts retrieved

- AccountQueryResponseV2KeyPaginatedStringServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` AccountQueryResponseV2KeyPaginatedString
    - `nextKey` string, nullable — The next key that should be provided to the cursor parameter to fetch the next page, or null if this is the last page.
    - `results` AccountQueryResponseV2[] — Results for this page.
      - `accountNumber` string — The Account Number. Example: ACC-511274-31364-54
      - `regionCode` string — The region code of the account. Example: US
      - `accountName` string — The name of the account

## Other responses

- `401` — Unauthorized
- `403` — Missing required permission for this endpoint or resource
- `422` — Failed to query managed accounts

---

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