> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getlilac.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Status and Model Performance

> Query the public Lilac status endpoint for live model uptime, throughput, and time-to-first-token metrics across configurable aggregation windows.

The status endpoint returns recent live model performance and availability snapshots for the Lilac API. It is public and does **not** require authentication.

## Endpoint

```
GET https://api.getlilac.com/status
```

## Query Parameters

| Parameter | Type     | Description                                                                                                                 |
| --------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| `window`  | `string` | Optional time window for aggregation. Supported values: `5m`, `1h`, `24h`, `30d`. We recommend explicitly passing `window`. |

## Example

```bash theme={null}
curl "https://api.getlilac.com/status?window=5m"
```

## Response

```json theme={null}
{
  "updated_at": "2025-01-15T18:42:11Z",
  "window": "5m",
  "window_secs": 300,
  "stale": false,
  "models": [
    {
      "id": "moonshotai/kimi-k2.6",
      "name": "Kimi K2.6",
      "tps": 142.7,
      "ttfb_seconds": 0.41,
      "uptime_pct": 99.8
    }
  ]
}
```

### Fields

| Field                   | Type              | Description                                                                                    |
| ----------------------- | ----------------- | ---------------------------------------------------------------------------------------------- |
| `updated_at`            | `string`          | Timestamp for the snapshot.                                                                    |
| `window`                | `string`          | Aggregation window used.                                                                       |
| `window_secs`           | `integer`         | Aggregation window in seconds.                                                                 |
| `stale`                 | `boolean`         | Whether the data may be stale.                                                                 |
| `models`                | `array`           | Array of model status entries.                                                                 |
| `models[].id`           | `string`          | Model ID.                                                                                      |
| `models[].name`         | `string`          | Display name.                                                                                  |
| `models[].tps`          | `float` \| `null` | Average throughput in tokens/sec. `null` when not enough recent data exists.                   |
| `models[].ttfb_seconds` | `float` \| `null` | Average time to first token, in seconds. `null` when not enough recent data exists.            |
| `models[].uptime_pct`   | `float` \| `null` | Request success percentage for the selected window. `null` when not enough recent data exists. |

<Note>
  Low-traffic models may return `null` metrics for shorter windows. If you see `null` values, retry with a wider window such as `1h`, `24h`, or `30d`.
</Note>
