---
title: "Lists a page of the pool's live nodes in node key order. A node is listed while its heartbeat is recent enough for it to receive actors."
method: GET
path: "/pools/{pool}/nodes"
tags: ["pools"]
---

# Lists a page of the pool's live nodes in node key order. A node is listed while its heartbeat is recent enough for it to receive actors.

`GET /pools/{pool}/nodes`

## Request

- Base URL: `https://api.rivet.dev`
- URL: `https://api.rivet.dev/pools/{pool}/nodes`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-rivet-token`

## Path parameters

- `pool` string, required

## Query parameters

- `namespace` string
- `limit` integer
- `cursor` string

## Response `200`

A page of live nodes.

- PoolsListNodesResponse
  - `nodes` Node[], required
    - `key` string, required: Node key, unique within the pool.
    - `pool` string, required: Name of the node pool.
    - `namespace` string, required: Name of the namespace.
    - `datacenter` string, required: Datacenter name.
    - `version` integer, required: Version the node announced when it connected. New actors are placed only on nodes at the newest version with a connected node in the pool.
    - `create_ts` integer, required: When the node connected, in Unix milliseconds.
    - `last_ping_ts` integer, required: When the node last sent a heartbeat, in Unix milliseconds.
    - `connected` boolean, required: Whether the node is connected.
    - `stopping` boolean, required: Whether the node is shutting down.
  - `pagination` Pagination, required
    - `cursor` string, nullable, required: Cursor for the next page, or `null` when there are no more results.

## Other responses

- `400`: `actor.invalid_limit`: `limit` is not an integer from 1 to 100. `actor.invalid_cursor`: `cursor` is malformed. `envoy.invalid_pool_name`: the pool name is not valid. `envoy.invalid_namespace_name`: the `namespace` value is not a DNS label of 1 to 63 lowercase letters, digits and hyphens.
- `401`: `auth.invalid_token`: the request carries no token, or the token is not valid. `auth.token_expired`: the token has expired.
- `403`: `auth.insufficient_permissions`: the token's grants do not cover this request.
- `404`: `namespace.not_found`: the namespace does not exist.
- `500`: `core.internal_error`: an unexpected failure. Details are only logged on the server.
- `503`: `auth.verification_unavailable`: token verification keys are temporarily unavailable. Retry the request.

## Changes

- **2026-11-03** `531e21275aec`: 1 info
  - added the required property `nodes/items/version` to the response with the `200` status
- **2026-10-31** `aa8d1a8a5d14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rivet-dev/apis/rivet-api-public/changes/pools/:pool/nodes/get.md)

---

[API](https://skmtc.dev/rivet-dev/apis/rivet-api-public.md) - [All operations](https://skmtc.dev/rivet-dev/apis/rivet-api-public/llms.txt) - [OpenAPI document](https://skmtc.dev/rivet-dev/apis/rivet-api-public/revisions/531e21275aec?raw)