--- title: "List Nodes" method: GET path: "/v1/ai-gateways/{gatewayId}/nodes" tags: ["AI Gateway Nodes"] --- # List Nodes `GET /v1/ai-gateways/{gatewayId}/nodes` ## Request - Base URL: `https://global.api.konghq.com` - URL: `https://global.api.konghq.com/v1/ai-gateways/{gatewayId}/nodes` - Auth: one of: - HTTP bearer - HTTP bearer - HTTP bearer - HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. - `config_sync` AIGatewayDataPlaneNodeConfigSync - `state` 'STATE_UNSPECIFIED' | 'STATE_IN_SYNC' | 'STATE_PENDING' | 'STATE_RESILIENCY': Config sync state. - `version_id` string: The version ID of the configuration currently applied by the node. - `resiliency` AIGatewayDataPlaneNodeResiliency: Present when the control plane is serving the node's last-known-good configuration because the current configuration could not be applied. - `fallback_config_version` string: The configuration version of the fallback config in use. - `activated_at` integer: The timestamp when the resiliency state was activated. - `latest_config_errors` AIGatewayDataPlaneNodeError[]: The list of errors encountered when applying the latest configuration. - `name` string, required - `error_message` string, required - `config_hash` string - `flattened_errors` AIGatewayDataPlaneNodeFlattenedError[] - `entity_id` string - `entity_name` string - `entity_type` string - `errors` AIGatewayDataPlaneNodeErrorDetail[] - … - `fields` object - `code` integer, required - `source` string, required - `traceback` string, required - `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. - `labels` PublicLabels: Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_". - `meta` CursorMetaWithTotal, required: Pagination metadata with exact total. Useful when the collection size is inexpensive to provide. - `page` object, 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 - `total` number, required: Total number of objects in the collection ## Other responses - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `429`: Too Many Requests ## Changes - **2026-09-30** `de79e1192f11`: 1 info - added the optional property `data/items/config_sync` to the response with the `200` status - **2026-09-25** `68d43091b84d`: 2 warning - added the new `403.00` enum value to the `status` response property for the response status `403` - added the new `404.00` enum value to the `status` response property for the response status `404` - **2026-09-18** `f324fb7610e4`: 3 breaking, 23 info - the response's body type changed from no type to `object` for status `403` - the response's body type changed from no type to `object` for status `404` - the response's body type changed from no type to `object` for status `429` - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401` - …22 more - **2026-09-07** `d2254a6fbee0`: 1 info - added the optional property `data/items/labels` to the response with the `200` status - **2026-08-24** `46dabd88efd3`: 4 breaking, 2 warning, 1 info - the `meta/page` response's property type changed from `object` to no type for status `200` - removed the required property `meta/page/next` from the response with the `200` status - removed the required property `meta/page/previous` from the response with the `200` status - removed the required property `meta/page/size` from the response with the `200` status - …3 more [Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/ai-gateways/:gatewayId/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.dev/kong/apis/konnect-api-go-sdk/revisions/ff8439091e5f?raw)