---
title: "Get cluster node list"
method: GET
path: "/api/{org_id}/node/list"
tags: ["Organizations"]
---

# Get cluster node list

`GET /api/{org_id}/node/list`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/node/list`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/node/list/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a hierarchical list of all nodes in the OpenObserve cluster organized by regions and clusters, with detailed information about each node including versions and roles. Useful for monitoring cluster health and managing distributed deployments.

## Path parameters

- `org_id` string, required

## Query parameters

- `regions` string

## Response `200`

Success

- object: Response struct for node listing with nested hierarchy Contains a three-level hierarchy with a flat format: 1. Regions at the top level as object keys 2. Clusters within each region as object keys 3. Nodes as arrays directly under each cluster

## Other responses

- `403`: Forbidden - Not the _meta organization
- `404`: NotFound

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)