---
title: "Get a list of CPs mapped to Context Interface"
method: GET
path: "/v1/context-interfaces/{interfaceId}/control-plane-mappings"
tags: ["Control Plane Mappings"]
---

# Get a list of CPs mapped to Context Interface

`GET /v1/context-interfaces/{interfaceId}/control-plane-mappings`

**Pre-release Endpoint**
This endpoint is currently in beta and is subject to change.

Get a list of all Control Planes that have been mapped to the given Context Interface.

## Query parameters

- `page` CursorPageParameters
  - `size` integer — The number of items included per page.
  - `after` string — Cursor param specifying the page (i.e. the next page) of data returned.
  - `before` string — Cursor param specifying the page (i.e. the previous page) of data returned.
- `filter` object
  - `control_plane_id` UuidFieldFilter — Filter using **one** of the following operators: `eq`, `oeq`, `neq`
    - `eq` string — The field exactly matches the provided value.
    - `oeq` string — The field matches any of the provided values.
    - `neq` string — The field does not match the provided value.

## Response `200`

Listing MCP Server to Control Plane mappings.

- ListMCPServerControlPlaneMappingResponse
  - `data` MCPServerControlPlaneMappingInfo[], required
    - `id` string, uuid, required — The unique identifier for the mapping.
    - `context_interface_id` string, uuid, required — The unique identifier for the Context Interface.
    - `control_plane_id` string, uuid, required — The unique identifier for the Control Plane.
    - `mode` 'basic' | 'advanced', required — Whether the Context Interface deployment on this Control Plane is managed by Konnect defaults ('basic') or configured directly via Kong Operator custom resources ('advanced').
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
  - `meta` CursorMeta, required — Pagination metadata.
    - `page` CursorMetaPage, required
      - `first` string, path — URI to the first page
      - `last` string, path — URI to the last page
      - `next` string, path, nullable, required — URI to the next page
      - `previous` string, path, nullable, required — URI to the previous page
      - `size` number, required — Requested page size

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-09-30** `de79e1192f11` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/context-interfaces/:interfaceId/control-plane-mappings/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/de79e1192f11?raw)