---
title: "List Replicas"
method: GET
path: "/endpoints/{endpoint_id}/replicas"
tags: ["Replicas"]
---

# List Replicas

`GET /endpoints/{endpoint_id}/replicas`

Returns live replica details for an active endpoint.

## Path parameters

- `endpoint_id` string, required

## Response `200`

List of replicas.

- ReplicaResponse[]
  - `replica_id` string — Unique replica ID.
  - `state` string — Replica state (RUNNING, STARTING, STOPPING, etc.).
  - `node_id` string, nullable — Node ID where the replica is running.
  - `node_ip` string, nullable — Node IP address.
  - `actor_id` string, nullable — Ray actor ID.
  - `actor_name` string, nullable — Ray actor name.
  - `worker_id` string, nullable — Ray worker ID.
  - `pid` integer, nullable — Process ID.
  - `start_time_s` number, nullable — Replica start time (Unix timestamp in seconds).

---

[API](https://skmtc.net/aieev/apis/aircloud-external-api.md) · [All operations](https://skmtc.net/aieev/apis/aircloud-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aieev/aircloud-external-api/versions/5cb76994bce9/schema)