---
title: "List Data Plane Node Records"
method: GET
path: "/v2/control-planes/{controlPlaneId}/nodes"
tags: ["DP Nodes"]
---

# List Data Plane Node Records

`GET /v2/control-planes/{controlPlaneId}/nodes`

Returns a list of data plane node records that are associated to this control plane. A data plane node record contains metadata information for the data plane running Kong Gateway.

## Query parameters

- `page[size]` integer
- `page[after]` string

## Response `200`

Example response

- object
  - `items` object[]
    - `id` string
    - `version` string
    - `hostname` string
    - `last_ping` integer
    - `type` string
    - `created_at` integer
    - `updated_at` integer
    - `config_hash` string
    - `compatibility_status` object
      - `state` string
      - `issues` NodeCompatibilityIssue[]
        - `code` string — The compatibility issue code.
        - `severity` string — The severity of the issue.
        - `description` string — The description of the issue.
        - `resolution` string — Steps required to take in order to resolve the issue.
        - `affected_resources` NodeCompatibilityIssueAffectedResource[] — Details of the resources affected by the issue.
          - `id` string — ID of the affected resource.
          - `type` string — Type of the affected resource.
          - `parent_code` string — Parent Issue Code.
          - `details` string[] — Deatils of the affected resource.
        - `documentation_url` string — Doc URL for the compatibility issue.
  - `page` object
    - `total_count` integer
    - `next` string

## Changes

- **2026-06-23** `bb5e056b7c6d` — 1 warning, 1 info
  - removed the optional property `page/total` from the response with the `200` status
  - added the optional property `page/total_count` to the response with the `200` status
- **2026-02-12** `b9b4ba83d16d` — 1 info
  - added the optional property `items/items/compatibility_status/issues` to the response with the `200` status
- **2025-08-22** `3c0154b2053a` — 11 breaking
  - the response property `items` became nullable for the status `200`
  - the response property `items/items/compatibility_status` became nullable for the status `200`
  - the response property `items/items/compatibility_status/state` became nullable for the status `200`
  - the response property `items/items/config_hash` became nullable for the status `200`
  - …7 more

[Change history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v2/control-planes/:controlPlaneId/nodes/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-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api-go-sdk/revisions/7d3c634668f8/schema)