---
title: "Get model status"
method: GET
path: "/api/models/{model_name}/status/"
tags: ["Models"]
---

# Get model status

`GET /api/models/{model_name}/status/`

## Request

- Base URL: `https://api.respan.ai`
- URL: `https://api.respan.ai/api/models/{model_name}/status/`
- Auth: one of:
  - none
  - HTTP bearer
  - HTTP bearer

Get public uptime and normalized performance metrics for an exact logged model string. Authentication is optional. Public callers receive redacted volume fields.

## Path parameters

- `model_name` string, required

## Query parameters

- `provider_id` string, nullable
- `start_time` string, required: ISO-8601 or epoch timestamp. Raw window max 90 days.
- `end_time` string, required: Timestamp after start_time.
- `time_tick` 'minute' | 'hour' | 'day'

## Response `200`

Model status series. Unknown model names return empty series rather than 404.

- ModelStatusResponse
  - `model` string, required
  - `provider_id` string, nullable, required
  - `time_tick` 'minute' | 'hour' | 'day', required
  - `start_time` string, date-time, required
  - `end_time` string, date-time, required
  - `data` ModelStatusUptimeBucket[], required
    - `date_group` string, date-time, required
    - `uptime` number, nullable, required
    - `total_count` integer: Staff-only.
    - `down_count` integer: Staff-only.
  - `respan_uptime` ModelStatusUptimeBucket[]: Omitted when provider_id is supplied.
    - `date_group` string, date-time, required
    - `uptime` number, nullable, required
    - `total_count` integer: Staff-only.
    - `down_count` integer: Staff-only.
  - `metrics_series` ModelStatusMetricBucket[], required
    - `date_group` string, date-time, required
    - `average_tps` number, nullable
    - `average_ttft` number, nullable
    - `average_latency` number, nullable
    - `cache_hit_percentage` number, nullable
    - `number_of_requests` integer: Staff-only.
    - `cost` number, nullable: Staff-only.
  - `status` object: Omitted when provider_id is supplied. Volume fields are staff-only.
    - `uptime_percent` number, nullable
    - `average_tps` number, nullable
    - `average_ttft` number, nullable
    - `average_latency` number, nullable
    - `cache_hit_percentage` number, nullable
    - `input_cost` number, nullable
    - `number_of_requests` integer
    - `cost` number, nullable
    - `prompt_tokens` integer
    - `completion_tokens` integer
    - `prompt_cache_hit_tokens` integer
    - `prompt_cache_creation_tokens` integer

## Other responses

- `400`: Invalid timestamps, range, provider, or time tick.
- `429`: Anonymous callers are limited to 30 requests per minute per IP.

## Changes

- **2026-10-21** `c30bcb383ee8`: 29 breaking, 4 info
  - the response property `data/items/uptime` became nullable for the status `200`
  - the response property `metrics_series/items/average_latency` became nullable for the status `200`
  - the response property `metrics_series/items/average_tps` became nullable for the status `200`
  - the response property `metrics_series/items/average_ttft` became nullable for the status `200`
  - …29 more
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `RespanApiKey` was added to the API
- **2026-09-12** `22b868ef3f22`: 1 info
  - api operation id `api-models-status-retrieve` removed and replaced with `models_api_models_status_retrieve`

[Operation history](https://skmtc.dev/respan/apis/respan-api/changes/api/models/:model_name/status/get.md)

---

[API](https://skmtc.dev/respan/apis/respan-api.md) - [All operations](https://skmtc.dev/respan/apis/respan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/respan/apis/respan-api/revisions/900841387635?raw)