Get model status with filters

curl -X POST https://api.respan.ai/api/models/model_name/status/ \
     -H "Authorization: Bearer <respanApiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "start_time": "string",
  "end_time": "string"
}'

{
  "model": "string",
  "provider_id": "string",
  "time_tick": "minute",
  "start_time": "2024-01-15T09:30:00Z",
  "end_time": "2024-01-15T09:30:00Z",
  "data": [
    {
      "date_group": "2024-01-15T09:30:00Z",
      "uptime": 1.1,
      "total_count": 1,
      "down_count": 1
    }
  ],
  "metrics_series": [
    {
      "date_group": "2024-01-15T09:30:00Z",
      "average_tps": 1.1,
      "average_ttft": 1.1,
      "average_latency": 1.1,
      "cache_hit_percentage": 1.1,
      "number_of_requests": 1,
      "cost": 1.1
    }
  ],
  "respan_uptime": [
    {
      "date_group": "2024-01-15T09:30:00Z",
      "uptime": 1.1,
      "total_count": 1,
      "down_count": 1
    }
  ],
  "status": {
    "uptime_percent": 1.1,
    "average_tps": 1.1,
    "average_ttft": 1.1,
    "average_latency": 1.1,
    "cache_hit_percentage": 1.1,
    "input_cost": 1.1,
    "number_of_requests": 1,
    "cost": 1.1,
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "prompt_cache_hit_tokens": 1,
    "prompt_cache_creation_tokens": 1
  }
}

Query parameters override matching values in the request body.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

model_namestringRequired

Exact logged model string; provider-prefixed values may contain a slash.

Request

This endpoint expects an object.

start_timestringRequired

ISO-8601 or epoch timestamp. Raw window max 90 days.

end_timestringRequired

Timestamp after start_time.

provider_idstring or nullOptional>=1 character

time_tickenumOptionalDefaults to day

Allowed values:

Response

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

modelstring

provider_idstring or null

time_tickenum

Allowed values:

start_timedatetime

end_timedatetime

datalist of objects

metrics_serieslist of objects

respan_uptimelist of objectsOptional

Omitted when provider_id is supplied.

statusobjectOptional

Omitted when provider_id is supplied. Volume fields are staff-only.

Errors

400

Bad Request Error

429

Too Many Requests Error