---
title: "List Endpoints"
method: GET
path: "/endpoints"
tags: ["Endpoints"]
---

# List Endpoints

`GET /endpoints`

Returns a paginated list of endpoints accessible by the current API key.

## Query parameters

- `search` string
- `is_active` boolean
- `page` integer
- `size` integer

## Response `200`

Paginated list of endpoints.

- EndpointListResponse
  - `items` EndpointListItem[] — Array of endpoint objects.
    - `id` string — Unique endpoint ID.
    - `name` string — Endpoint name.
    - `endpoint_type` string — Endpoint type.
    - `is_active` boolean — Whether the endpoint is currently active (running).
    - `status` string — Current status (RUNNING, STOPPED, DEPLOYING, etc.).
    - `num_replicas` integer — Current number of replicas.
    - `enable_autoscaling` boolean — Whether autoscaling is enabled.
    - `instance_type_name` string, nullable — Assigned instance type name.
    - `serving_endpoint_url` string, nullable — Public URL for the endpoint.
    - `created_at` string, date-time — Creation time (ISO 8601).
    - `updated_at` string, date-time — Last update time (ISO 8601).
  - `total` integer — Total number of endpoints.
  - `page` integer — Current page number.
  - `size` integer — Items per page.
  - `pages` integer — Total number of pages.

## Other responses

- `401` — Missing or invalid API key.

---

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