---
title: "List Control Planes"
method: GET
path: "/v1/mesh/control-planes"
tags: ["Mesh"]
---

# List Control Planes

`GET /v1/mesh/control-planes`

Returns an array of control planes objects.

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `filter` MeshControlPlaneFilterParameters
  - `name` object — Filter using **one** of the following operators: `eq`, `contains`
    - `eq` string — The field exactly matches the provided value.
    - `contains` string — The field contains the provided value.
  - `labels` LabelsFieldFilter — Filter using **one** of the following operators: `eq`, `oeq`, `neq`, `contains`, `ocontains`
    - `eq` string — The field exactly matches the provided value.
    - `contains` string — The field contains the provided value.
    - `ocontains` string — The field contains any of the provided values.
    - `oeq` string — The field matches any of the provided values.
    - `neq` string — The field does not match the provided value.

## Response `200`

A paginated list response for a collection of control planes.

- object
  - `meta` PaginatedMeta — returns the pagination information
    - `page` PageMeta, required — Contains pagination query parameters and the total number of objects returned.
      - `number` number, required
      - `size` number, required
      - `total` number, required
  - `data` MeshControlPlane[]
    - `id` string, uuid, required — ID of the control plane.
    - `name` string, required — The name of the control plane.
    - `description` string
    - `labels` MeshControlPlaneLabels, nullable — Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
    - `features` MeshControlPlaneFeature[]
      - `type` 'MeshCreation' | 'HostnameGeneratorCreation', required
      - `hostnameGeneratorCreation` MeshControlPlaneFeatureHostnameGenerationCreation
        - `enabled` boolean, required
      - `meshCreation` MeshControlPlaneFeatureMeshCreation
        - `enabled` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `401` — Unauthorized Error
- `403` — Permission denied

---

[API](https://skmtc.net/kong/apis/konnect-api.md) · [All operations](https://skmtc.net/kong/apis/konnect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kong/konnect-api/revisions/06734a9c491f/schema)