---
title: "Filter model status"
method: POST
path: "/api/models/{model_name}/status/"
tags: ["models"]
---

# Filter model status

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

POST-for-filtering model status. Manually supplied query parameters override the same body values.

## Path parameters

- `model_name` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `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, double, 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, double, 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, double, nullable
    - `average_ttft` number, double, nullable
    - `average_latency` number, double, nullable
    - `cache_hit_percentage` number, double, nullable
    - `number_of_requests` integer — Staff-only.
    - `cost` number, double, nullable — Staff-only.
  - `status` ModelStatusResponseStatus — Omitted when provider_id is supplied. Volume fields are staff-only.
    - `uptime_percent` number, double, nullable
    - `average_tps` number, double, nullable
    - `average_ttft` number, double, nullable
    - `average_latency` number, double, nullable
    - `cache_hit_percentage` number, double, nullable
    - `input_cost` number, double, nullable
    - `number_of_requests` integer
    - `cost` number, double, 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.

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/4e064cf81dae/schema)