GIgitlab
namespaces

List all namespaces

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

get/api/v4/namespaces

Request

  • Base URL
    https://gitlab.com
  • Auth
    none declared

Query parameters

searchstring

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

owned_onlyboolean

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

top_level_onlyboolean

Only include top level namespaces

full_path_searchboolean

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

pageinteger

Current page number

per_pageinteger

Number of items per page

requested_hosted_planstring

Name of the hosted plan requested by the customer

Response

List all namespaces

idinteger required
namestring required
pathstring required
kindstring required
full_pathstring required
parent_idinteger required
avatar_urlstring required
web_urlstring required
members_count_with_descendantsinteger
root_repository_sizeinteger
projects_countinteger
shared_runners_minutes_limitinteger
extra_shared_runners_minutes_limitinteger
additional_purchased_storage_sizeinteger
additional_purchased_storage_ends_onstring date
billable_members_countinteger required
seats_in_useinteger
max_seats_usedinteger
max_seats_used_changed_atstring date
end_datestring date
planstring
trial_ends_onstring date
trialboolean

Example response

[
  {
    "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,
    "ci_minutes_usage": {
      "total_minutes_used": 105,
      "monthly_minutes_used": 100,
      "purchased_minutes_used": 5
    },
    "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"
  }
]

Changes

No recorded changes to this operation across all 5 revisions of this API.