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

# Server telemetry (optional)

> Counters kept by the sample AI server when telemetry is enabled. Also served at /api/telemetry.

Counters kept by the sample AI server when telemetry is enabled. Also served at `/api/telemetry`.

### Response

`Telemetry`

<ResponseField name="ok" type="boolean" />

<ResponseField name="generatedAt" type="string (date-time)" />

<ResponseField name="telemetry" type="object">
  <Expandable title="telemetry">
    <ResponseField name="requests" type="number" />

    <ResponseField name="errors" type="number" />

    <ResponseField name="avgLatencyMs" type="number" />

    <ResponseField name="lastLatencyMs" type="number" />

    <ResponseField name="kbHits" type="number" />

    <ResponseField name="kbMisses" type="number" />

    <ResponseField name="last" type="object">
      <Expandable title="last">
        <ResponseField name="provider" type="string" />

        <ResponseField name="model" type="string" />

        <ResponseField name="stream" type="boolean" />
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning |
| ----- | ------- |
| `200` | OK      |
| `401` | Error   |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.example.com/api/response/telemetry' \
    --header 'x-widget-token: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true,
    "generatedAt": "2026-08-31T14:22:05Z",
    "telemetry": {
      "requests": 1.5,
      "errors": 1.5,
      "avgLatencyMs": 250,
      "lastLatencyMs": 250,
      "kbHits": 1.5,
      "kbMisses": 1.5,
      "last": {
        "provider": "string",
        "model": "string",
        "stream": true
      }
    }
  }
  ```
</ResponseExample>