---
title: "List Nodes"
method: GET
path: "/v1/ai-gateways/{gatewayId}/nodes"
tags: ["AI Gateway Nodes"]
---

# List Nodes

`GET /v1/ai-gateways/{gatewayId}/nodes`

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

Returns a list of nodes associated with the specified AI Gateway.

## Query parameters

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

## Response `200`

A successful response listing AI Gateway Data Plane Nodes.

- object
  - `data` AIGatewayDataPlaneNode[], required
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `version` string, required
    - `hostname` string, required
    - `last_ping` integer, required
    - `type` string, required
    - `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.
    - `config_version` string — The version of the configuration applied by the node.
    - `errors` AIGatewayDataPlaneNodeError[] — Validation or configuration errors reported by the data plane node.
      - `name` string, required
      - `error_message` string, required
      - `config_hash` string
      - `flattened_errors` AIGatewayDataPlaneNodeFlattenedError[]
        - `entity_id` string
        - `entity_name` string
        - `entity_type` string
        - `errors` AIGatewayDataPlaneNodeErrorDetail[]
          - `error_message` string
          - `type` string
          - `field` string
      - `fields` object
      - `code` integer, required
      - `source` string, required
      - `traceback` string, required
    - `compatibility_status` object, required
      - `state` string
      - `issues` AIGatewayDataPlaneNodeCompatibilityIssue[]
        - `code` string, required — The compatibility issue code.
        - `severity` string, required — The severity of the issue.
        - `description` string, required — The description of the issue.
        - `resolution` string, required — Steps required to take in order to resolve the issue.
        - `affected_resources` AIGatewayDataPlaneNodeCompatibilityIssueAffectedResource[], required — Details of the resources affected by the issue.
          - `id` string, required — ID of the affected resource.
          - `type` string, required — Type of the affected resource.
          - `parent_code` string, required — Parent Issue Code.
          - `details` string[], required — Details of the affected resource.
        - `documentation_url` string, required — Doc URL for the compatibility issue.
  - `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

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

---

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