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

# Get managed accounts

`GET /public/v2/managed/accounts`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/managed/accounts`
- Auth: HTTP bearer

Required permission: Managed Account Information, View.<br/>Get managed accounts within your account hierarchy with filtering and pagination support.
Returns up to 100 accounts at a time.

## 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 get managed accounts

---

[API](https://skmtc.dev/starlink/apis/starlink-management-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-management-api/revisions/dfd7014cfd6d?raw)