> ## Documentation Index > Fetch the complete documentation index at: https://www.latitude.sh/docs/llms.txt > Use this file to discover all available pages before exploring further. # List nodes > Lists the nodes of a node pool, with the status of each node and of the server it runs on. Each node's `id` is a stable node ID (format: `lksno_`); `name` is its Kubernetes node name, as shown by `kubectl get nodes`. The response is not paginated; `meta.total` is the number of nodes returned. ## OpenAPI ````yaml https://spec.speakeasy.com/latitude/latitude/latitude-sh-api-with-code-samples get /lks/clusters/{cluster_id}/nodepools/{node_pool_id}/nodes openapi: 3.0.1 info: title: Latitude.sh API version: '2023-06-01' description: >- The Latitude.sh API is a RESTful API to manage your Latitude.sh account. It allows you to perform the same actions as the Latitude.sh dashboard. servers: - url: https://api.latitude.sh variables: latitude_api_key: default: - url: http://api.latitude.sh variables: latitude_api_key: default: security: [] tags: - name: API keys - name: Baselines (Preview) description: >- Preview. Available to teams with the `baselines_api` feature flag. The shape of these endpoints may change before general availability. - name: Billing - name: Elastic Ips - name: Events - name: Firewalls - name: IP Addresses - name: Managed Databases description: Managed database instances (PostgreSQL, ClickHouse) - name: Kubernetes Clusters - name: LKS - name: Marketplace apps - name: Operating Systems - name: Plans - name: Public Networks - name: Private Networks - name: Projects - name: Regions - name: Roles - name: SSH Keys - name: Servers - name: Block Storage - name: Filesystem Storage - name: Object Storage - name: Tags - name: Teams - name: Team members - name: Traffic - name: User data - name: User profile - name: VPN Sessions - name: Virtual machines - name: Virtual machine backups - name: Virtual machine restores paths: /lks/clusters/{cluster_id}/nodepools/{node_pool_id}/nodes: get: tags: - LKS summary: List nodes description: > Lists the nodes of a node pool, with the status of each node and of the server it runs on. Each node's `id` is a stable node ID (format: `lksno_`); `name` is its Kubernetes node name, as shown by `kubectl get nodes`. The response is not paginated; `meta.total` is the number of nodes returned. operationId: list-lks-nodes parameters: - name: cluster_id in: path required: true description: 'The cluster ID (format: `lksc_`).' schema: type: string - name: node_pool_id in: path required: true description: 'The node pool ID (format: `lksnp_`).' schema: type: string - name: filter[status] in: query required: false description: >- Only return nodes in this status: `pending`, `ready`, `not_ready`, or `deleting`. schema: type: string responses: '200': description: OK content: application/vnd.api+json: examples: OneNode: value: data: - id: lksno_3f9a2c71d0e84b type: lks_nodes attributes: name: lksc-cd85490c6ee940-lksnp-d25a5b77339c45-cc286-42kpp status: not_ready reason: NodeUnreachable message: Kubelet stopped posting node status server: id: sv_9dQKr1pRMLyd status: 'on' joined_at: '2026-09-01T12:15:00Z' created_at: '2026-09-01T12:05:00Z' updated_at: '2026-09-01T12:22:00Z' meta: total: 1 schema: $ref: '#/components/schemas/lks_nodes' '403': description: User Authorization Error content: application/vnd.api+json: examples: InsufficientPermissions: summary: The billing role cannot list nodes value: errors: - code: USER_AUTHORIZATION_ERROR title: User Authorization Error detail: You are not authorized to perform this action. status: '403' meta: {} schema: $ref: '#/components/schemas/error_object' '404': description: Not Found content: application/vnd.api+json: examples: ClusterNotFound: summary: Unknown cluster, or a cluster owned by another team value: errors: - code: NOT_FOUND title: Not Found detail: Cluster 'lksc_pRMLydp0dQKr1' not found status: '404' meta: {} NodePoolNotFound: summary: Unknown node pool, or a node pool of another cluster value: errors: - code: NOT_FOUND title: Not Found detail: Node pool 'lksnp_d25a5b77339c45' not found status: '404' meta: {} schema: $ref: '#/components/schemas/error_object' '502': description: Bad Gateway — NetBox is temporarily unavailable content: application/vnd.api+json: examples: UpstreamServiceError: value: errors: - code: UPSTREAM_SERVICE_ERROR title: Bad Gateway detail: NetBox is temporarily unavailable. Please try again. status: '502' meta: {} schema: $ref: '#/components/schemas/error_object' security: - Bearer: [] x-codeSamples: - lang: go label: Go (SDK) source: "package main\n\nimport(\n\t\"context\"\n\t\"os\"\n\tlatitudeshgosdk \"github.com/latitudesh/latitudesh-go-sdk\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := latitudeshgosdk.New(\n latitudeshgosdk.WithSecurity(os.Getenv(\"LATITUDESH_BEARER\")),\n )\n\n res, err := s.Lks.ListLksNodes(ctx, \"\", \"\", nil)\n if err != nil {\n log.Fatal(err)\n }\n if res.LksNodes != nil {\n // handle response\n }\n}" - lang: typescript label: Typescript (SDK) source: |- import { Latitudesh } from "latitudesh-typescript-sdk"; const latitudesh = new Latitudesh({ bearer: process.env["LATITUDESH_BEARER"] ?? "", }); async function run() { const result = await latitudesh.lks.listLksNodes({ clusterId: "", nodePoolId: "", }); console.log(result); } run(); components: schemas: lks_nodes: type: object properties: data: type: array items: $ref: '#/components/schemas/lks_node_data' meta: type: object properties: total: type: integer error_object: type: object properties: errors: type: array items: type: object properties: code: type: string nullable: true status: type: string title: type: string detail: type: string source: type: object properties: pointer: type: string parameter: type: string meta: type: object lks_node_data: type: object properties: id: type: string example: lksno_3f9a2c71d0e84b type: type: string enum: - lks_nodes attributes: type: object properties: name: type: string example: lksc-cd85490c6ee940-lksnp-d25a5b77339c45-cc286-42kpp description: The Kubernetes node name, as shown by `kubectl get nodes` status: type: string nullable: true example: ready description: 'Open set: pending, ready, not_ready, deleting' reason: type: string nullable: true example: NodeUnreachable description: >- Machine-readable status reason (open enum); empty or null when none is reported message: type: string nullable: true description: Human-readable detail of the status server: type: object nullable: true description: The server the node runs on; null until the node is bound to one properties: id: type: string example: sv_9dQKr1pRMLyd status: type: string nullable: true example: 'on' joined_at: type: string nullable: true created_at: type: string nullable: true updated_at: type: string nullable: true securitySchemes: Bearer: type: apiKey name: Authorization in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.