---
title: "Get endpoint replicas [READ]"
method: GET
path: "/v2/endpoint/{namespace}/{name}/replica"
tags: ["Endpoints"]
---

# Get endpoint replicas [READ]

`GET /v2/endpoint/{namespace}/{name}/replica`

## Path parameters

- `namespace` string, required
- `name` string, required

## Response `200`

Endpoint replicas returned successfully

- Replicas — Status of endpoint replicas
  - `items` Replica[], required
    - `id` string, required
    - `status` ReplicaStatus, required — Status of an endpoint replica
      - `exitCode` integer, nullable — Replica exit code
      - `live` boolean, required — True if the replica is part of the live endpoint version
      - `stage` 'pending' | 'downloading' | 'pulling' | 'initializing' | 'running' | 'terminating' | 'stopped', required — Stage of an endpoint replica
      - `startedAt` string, date-time, nullable — Time when the replica started
      - `stoppedAt` string, date-time, nullable — Time when the replica stopped
      - `updating` boolean, required — True if the replica is part of the updating endpoint version If the update succeed this version will replace the live one
    - `versionId` string, required — Unique identifier of the endpoint version

---

[API](https://skmtc.net/huggingface/apis/hf-inference-endpoints-api.md) · [All operations](https://skmtc.net/huggingface/apis/hf-inference-endpoints-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hf-inference-endpoints-api/versions/52e3f4cdbf86/schema)