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
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “ Query Parameters ” search
string
Returns a list of namespaces the user is authorized to view based on the search criteria
owned_only
boolean
In GitLab 14.2 and later, returns a list of owned namespaces only
top_level_only
boolean
Only include top level namespaces
full_path_search
boolean
If true, the search parameter is matched against the full path of the namespaces
page
integer
Current page number
Example
1 per_page
integer
Number of items per page
Example
20 requested_hosted_plan
string
Name of the hosted plan requested by the customer
Responses
Section titled “ Responses ”OK
Media type application/json
object
id
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"}Bad Request
Unauthorized