---
title: "List all namespaces"
method: GET
path: "/api/v4/namespaces"
tags: ["namespaces"]
---

# List all namespaces

`GET /api/v4/namespaces`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/namespaces`
- Auth: none declared

Lists all namespaces available to the current user. If the user is an administrator, this endpoint returns all namespaces in the instance.

## Query parameters

- `search` string
- `owned_only` boolean
- `top_level_only` boolean
- `full_path_search` boolean
- `page` integer
- `per_page` integer
- `requested_hosted_plan` string

## Response `200`

List all namespaces

- APIEntitiesNamespace[]
  - `id` integer, required
  - `name` string, required
  - `path` string, required
  - `kind` string, required
  - `full_path` string, required
  - `parent_id` integer, required
  - `avatar_url` string, required
  - `web_url` string, required
  - `members_count_with_descendants` integer
  - `root_repository_size` integer
  - `projects_count` integer
  - `shared_runners_minutes_limit` integer
  - `ci_minutes_usage` APIEntitiesCiMinutesUsage
    - `total_minutes_used` integer, required
    - `monthly_minutes_used` integer, required
    - `purchased_minutes_used` integer, required
  - `extra_shared_runners_minutes_limit` integer
  - `additional_purchased_storage_size` integer
  - `additional_purchased_storage_ends_on` string, date
  - `billable_members_count` integer, required
  - `seats_in_use` integer
  - `max_seats_used` integer
  - `max_seats_used_changed_at` string, date
  - `end_date` string, date
  - `plan` string
  - `trial_ends_on` string, date
  - `trial` boolean

## Other responses

- `401`: Unauthorized

---

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