---
title: "List all certificate-based clusters"
method: GET
path: "/api/v4/discover-cert-based-clusters"
tags: ["clusters"]
---

# List all certificate-based clusters

`GET /api/v4/discover-cert-based-clusters`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/discover-cert-based-clusters`
- Auth: none declared

Lists all certificate-based clusters associated with a project. This feature was introduced in GitLab 17.9.

## Query parameters

- `group_id` integer, required

## Response `200`

List all certificate-based clusters

- APIEntitiesDiscoveredClusters: API_Entities_DiscoveredClusters model
  - `groups` object, required
  - `projects` object, required

## Other responses

- `403`: Forbidden

---

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