---
title: "List model-compatible execution targets with tenant availability and rolling latency telemetry"
method: GET
path: "/v1/models"
---

# List model-compatible execution targets with tenant availability and rolling latency telemetry

`GET /v1/models`

## Request

- Base URL: `https://modelpilot.andycywu.cc`
- URL: `https://modelpilot.andycywu.cc/v1/models`
- Auth: HTTP bearer

## Response `200`

Successful response

- ModelList
  - `object` 'list', required
  - `data` object[], required
    - `id` string, required
    - `object` 'model', required
    - `owned_by` string, required
    - `connection_id` string
    - `upstream_model` string, required
    - `expected_latency_ms` number, required
    - `expected_latency_source` string, required
    - `telemetry_quality` string, required
    - `measured_latency` MeasuredLatency, required
      - `samples` integer, required
      - `average_ms` integer, required
      - `p50_ms` integer, required
      - `p95_ms` integer, required
      - `window_days` 30, required
      - `sample_limit` 2000, required
      - `truncated` boolean, required
      - `latest_at` string, date-time, required
      - `streaming_samples` integer, required
      - `time_to_first_token` LatencyBucket, required
        - `samples` integer, required
        - `average_ms` integer, required
        - `p50_ms` integer, required
        - `p95_ms` integer, required
      - `by_reasoning_effort` object, required
    - `supported_reasoning_efforts` string[], required
    - `capabilities` object, required
      - `chat_completions` boolean, required
      - `tool_calling` boolean, required
      - `streaming` boolean, required
    - `availability` object, required
      - `credential_configured` boolean, required
      - `circuit_open` boolean, required
      - `routable` boolean, required
      - `healthy` boolean, required
      - `circuit_state` 'closed' | 'open' | 'half_open' | 'probe_required', required
      - `probe_required` boolean, required
      - `retry_at` string, date-time, nullable
      - `last_failure_at` string, date-time, nullable
      - `last_success_at` string, date-time, nullable
      - `last_error_code` string, nullable

## Other responses

- `201`: Created
- `401`: Missing or invalid tenant API key

---

[API](https://skmtc.dev/andycywu/apis/modelpilot-task-api.md) · [All operations](https://skmtc.dev/andycywu/apis/modelpilot-task-api/llms.txt) · [OpenAPI document](https://skmtc.dev/andycywu/apis/modelpilot-task-api/revisions/5af2d641c7e1?raw)