List all namespaces

GET

/api/v4/namespaces

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

Authorizations

http
oauth2

Parameters

Query Parameters

search

string

nullable

Returns a list of namespaces the user is authorized to view based on the search criteria

owned_only

boolean

nullable

In GitLab 14.2 and later, returns a list of owned namespaces only

top_level_only

boolean

nullable

Only include top level namespaces

full_path_search

boolean

nullable

If true, the search parameter is matched against the full path of the namespaces

page

integer

default: 1 nullable

Current page number

Example

per_page

integer

default: 20 nullable

Number of items per page

Example

requested_hosted_plan

string

nullable

Name of the hosted plan requested by the customer

Responses

200

application/json

object

integer format: int64

name

string

path

string

kind

string

full_path

string

parent_id

integer format: int64

avatar_url

string

web_url

string

members_count_with_descendants

integer

root_repository_size

integer

projects_count

integer

shared_runners_minutes_limit

integer

extra_shared_runners_minutes_limit

integer

additional_purchased_storage_size

integer

additional_purchased_storage_ends_on

string format: date

billable_members_count

integer

seats_in_use

integer

max_seats_used

integer

max_seats_used_changed_at

string format: date

end_date

string format: date

plan

string

trial_ends_on

string format: date

trial

boolean

Example

{
  "id": 2,
  "name": "project",
  "path": "my_project",
  "kind": "project",
  "full_path": "group/my_project",
  "parent_id": 1,
  "avatar_url": "https://example.com/avatar/12345",
  "web_url": "https://example.com/group/my_project",
  "members_count_with_descendants": 5,
  "root_repository_size": 123,
  "projects_count": 123,
  "shared_runners_minutes_limit": 133,
  "extra_shared_runners_minutes_limit": 133,
  "additional_purchased_storage_size": 1000,
  "additional_purchased_storage_ends_on": "2022-06-18",
  "billable_members_count": 2,
  "seats_in_use": 5,
  "max_seats_used": 100,
  "max_seats_used_changed_at": "2022-06-18",
  "end_date": "2022-06-18",
  "plan": "default",
  "trial_ends_on": "2022-06-18"
}

400

Bad Request

401

Unauthorized