---
title: "Get Endpoint Status"
method: GET
path: "/endpoints/{endpoint_id}"
tags: ["Endpoints"]
---

# Get Endpoint Status

`GET /endpoints/{endpoint_id}`

Returns the current status of an endpoint. Includes replica status summary when active.

## Path parameters

- `endpoint_id` string, required

## Response `200`

Endpoint status.

- EndpointStatusResponse
  - `endpoint_id` string — Unique endpoint ID.
  - `name` string — Endpoint name.
  - `endpoint_type` string — Endpoint type.
  - `is_active` boolean — Whether the endpoint is active.
  - `status` string — Current status. When active, fetched in real-time from Ray Serve.
  - `num_replicas` integer — Current number of replicas.
  - `enable_autoscaling` boolean — Whether autoscaling is enabled.
  - `instance_type_name` string, nullable — Instance type name.
  - `serving_endpoint_url` string, nullable — Public endpoint URL.
  - `replica_status_summary` object, nullable — Replica count by status. Only available when endpoint is active.
  - `created_at` string, date-time — Creation time.
  - `updated_at` string, date-time — Last update time.

## Other responses

- `403` — Endpoint does not belong to your organization or project.
- `404` — Endpoint not found.

---

[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)