---
title: "List all descendant groups"
method: GET
path: "/api/v4/groups/{id}/descendant_groups"
tags: ["groups"]
---

# List all descendant groups

`GET /api/v4/groups/{id}/descendant_groups`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/groups/{id}/descendant_groups`
- Auth: none declared

Lists all descendant groups for a specified group.

## Path parameters

- `id` string, required

## Query parameters

- `statistics` boolean
- `archived` boolean
- `skip_groups` integer[]
- `all_available` boolean
- `visibility` 'private' | 'internal' | 'public'
- `search` string
- `owned` boolean
- `order_by` 'name' | 'path' | 'id' | 'similarity'
- `sort` 'asc' | 'desc'
- `min_access_level` 10 | 15 | 20 | 25 | 30 | 40 | 50
- `top_level_only` boolean
- `marked_for_deletion_on` string, date
- `active` boolean
- `repository_storage` string
- `page` integer
- `per_page` integer
- `with_custom_attributes` boolean

## Response `200`

List all descendant groups

- APIEntitiesGroup[]
  - `id` integer, required
  - `web_url` string, required
  - `name` string, required
  - `path` string, required
  - `description` string, required
  - `visibility` string, required
  - `share_with_group_lock` boolean, required
  - `require_two_factor_authentication` boolean, required
  - `two_factor_grace_period` integer, required
  - `project_creation_level` string, required
  - `auto_devops_enabled` string, required
  - `subgroup_creation_level` string, required
  - `emails_disabled` boolean, required
  - `emails_enabled` boolean, required
  - `show_diff_preview_in_email` boolean, required
  - `mentions_disabled` string, required
  - `lfs_enabled` boolean, required
  - `archived` boolean, required
  - `math_rendering_limits_enabled` boolean, required
  - `lock_math_rendering_limits_enabled` boolean, required
  - `crm_enabled` boolean, required
  - `resource_access_token_notify_inherited` boolean, required
  - `lock_resource_access_token_notify_inherited` boolean, required
  - `default_branch` string, required
  - `default_branch_protection` integer, required
  - `default_branch_protection_defaults` string, required
  - `avatar_url` string, required
  - `request_access_enabled` boolean, required
  - `full_name` string, required
  - `full_path` string, required
  - `created_at` string, required
  - `parent_id` string, required
  - `organization_id` integer, required
  - `shared_runners_setting` string, required
  - `max_artifacts_size` integer, required
  - `custom_attributes` APIEntitiesCustomAttribute: API_Entities_CustomAttribute model
    - `key` string, required
    - `value` string, required
  - `statistics` object
    - `storage_size` string, required
    - `repository_size` string, required
    - `wiki_size` string, required
    - `lfs_objects_size` string, required
    - `job_artifacts_size` string, required
    - `pipeline_artifacts_size` string, required
    - `packages_size` string, required
    - `snippets_size` string, required
    - `uploads_size` string, required
  - `marked_for_deletion_on` string, required
  - `root_storage_statistics` APIEntitiesNamespaceRootStorageStatistics
    - `build_artifacts_size` integer, required: CI artifacts size in bytes.
    - `container_registry_size` integer, required: container registry size in bytes.
    - `container_registry_size_is_estimated` boolean, required: Indicates whether the deduplicated container registry size for the namespace is an estimated value or not.
    - `dependency_proxy_size` integer, required: Dependency Proxy sizes in bytes.
    - `lfs_objects_size` integer, required: LFS objects size in bytes.
    - `packages_size` integer, required: Packages size in bytes.
    - `pipeline_artifacts_size` integer, required: CI pipeline artifacts size in bytes.
    - `repository_size` integer, required: Git repository size in bytes.
    - `snippets_size` integer, required: Snippets size in bytes.
    - `storage_size` integer, required: Total storage in bytes.
    - `uploads_size` integer, required: Uploads size in bytes.
    - `wiki_size` integer, required: Wiki size in bytes.
  - `ldap_cn` string, required
  - `ldap_access` string, required
  - `ldap_group_links` APIEntitiesLdapGroupLink
    - `cn` string, required
    - `group_access` integer, required
    - `provider` string, required
    - `filter` string
    - `member_role_id` integer
  - `saml_group_links` APIEntitiesSamlGroupLink
    - `name` string, required
    - `access_level` integer, required
    - `member_role_id` integer
    - `provider` string, required
  - `file_template_project_id` string
  - `wiki_access_level` string, required
  - `repository_storage` string
  - `duo_core_features_enabled` boolean: [Experimental] Indicates whether GitLab Duo Core features are enabled for the group
  - `duo_features_enabled` string
  - `lock_duo_features_enabled` string
  - `auto_duo_code_review_enabled` string
  - `web_based_commit_signing_enabled` string
  - `allow_personal_snippets` string
  - `duo_namespace_access_rules` string
  - `built_in_project_templates_enabled` boolean
  - `lock_built_in_project_templates_enabled` boolean

---

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