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

# Get managed account tree

`GET /public/v2/managed/accounts/tree`

## Request

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

Required permission: Managed Account Information, View.<br/>Gets the entire managed account hierarchy beneath the calling account.

## Query parameters

- `ancestorAccountNumber` string

## Response `200`

Account tree retrieved

- ManagedAccountTreeResponseV2ServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` ManagedAccountTreeResponseV2
    - `rootAccountNumber` string: The root account number
    - `tree` object: Dictionary mapping account numbers to tree nodes

## Other responses

- `401`: Unauthorized
- `403`: Missing required permission for this endpoint or resource
- `422`: Failed to retrieve managed account tree

---

[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)