---
title: "POST /providers/Microsoft.Management/getEntities"
method: POST
path: "/providers/Microsoft.Management/getEntities"
tags: ["Entities"]
---

# POST /providers/Microsoft.Management/getEntities

`POST /providers/Microsoft.Management/getEntities`

List all entities (Management Groups, Subscriptions, etc.) for the authenticated user.

## Query parameters

- `api-version` string, required
- `$skiptoken` string
- `$skip` integer
- `$top` integer
- `$select` string
- `$search` 'AllowedParents' | 'AllowedChildren' | 'ParentAndFirstLevelChildren' | 'ParentOnly' | 'ChildrenOnly'
- `$filter` string
- `$view` 'FullHierarchy' | 'GroupsOnly' | 'SubscriptionsOnly' | 'Audit'
- `groupName` string

## Headers

- `Cache-Control` string

## Response `200`

OK

- EntityListResult — Describes the result of the request to view entities.
  - `value` EntityInfo[] — The list of entities.
    - `id` string, nullable — The fully qualified ID for the entity. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    - `type` string, nullable — The type of the resource. For example, Microsoft.Management/managementGroups
    - `name` string — The name of the entity. For example, 00000000-0000-0000-0000-000000000000
    - `properties` EntityInfoProperties — The generic properties of an entity.
      - `tenantId` string, nullable — The AAD Tenant ID associated with the entity. For example, 00000000-0000-0000-0000-000000000000
      - `displayName` string, nullable — The friendly name of the management group.
      - `parent` EntityParentGroupInfo — (Optional) The ID of the parent management group.
        - `id` string — The fully qualified ID for the parent management group. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
      - `permissions` 'noaccess' | 'view' | 'edit' | 'delete' — The users specific permissions to this item.
      - `inheritedPermissions` 'noaccess' | 'view' | 'edit' | 'delete' — The users specific permissions to this item.
      - `numberOfDescendants` integer, nullable
      - `numberOfChildren` integer, nullable — Number of children is the number of Groups and Subscriptions that are exactly one level underneath the current Group.
      - `numberOfChildGroups` integer, nullable — Number of children is the number of Groups that are exactly one level underneath the current Group.
      - `parentDisplayNameChain` string[], nullable — The parent display name chain from the root group to the immediate parent
      - `parentNameChain` string[], nullable — The parent name chain from the root group to the immediate parent
  - `count` integer — Total count of records that match the filter
  - `nextLink` string — The URL to use for getting the next set of results.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/azure/apis/management-microsoft-management-managementgroups.md) · [All operations](https://skmtc.net/azure/apis/management-microsoft-management-managementgroups/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/management-microsoft-management-managementgroups/versions/8a88b7130da6/schema)