> ## 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.

# Status handler

> Service status, SLA metrics, and dependency health

### Response

`StatusResponse`

<ResponseField name="dependencies" type="DependencyStatus[]" required>
  Per-dependency health breakdown.

  <Expandable title="DependencyStatus">
    <ResponseField name="healthy" type="boolean" required />

    <ResponseField name="latency_ms" type="integer (int64)" />

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

    <ResponseField name="note" type="string" />
  </Expandable>
</ResponseField>

<ResponseField name="generated_at" type="string (date-time)" required>
  When this status document was generated.
</ResponseField>

<ResponseField name="incidents" type="IncidentSummary[]" required>
  Currently open incidents (none if empty).

  <Expandable title="IncidentSummary">
    <ResponseField name="id" type="string" required />

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

    <ResponseField name="severity" type="string" required />

    <ResponseField name="status" type="string" required />

    <ResponseField name="title" type="string" required />
  </Expandable>
</ResponseField>

<ResponseField name="region" type="string" required>
  Deployment region (GKE cluster region or explicit NSR\_REGION env).
</ResponseField>

<ResponseField name="sla" type="SlaSnapshot" required>
  <Expandable title="SlaSnapshot">
    <ResponseField name="client_error_count" type="integer (int64)" required />

    <ResponseField name="error_budget_burn_rate" type="number (double)" required>
      How fast we're consuming the error budget. 1.0 = on pace to exactly burn the entire SLA budget. >1.0 = we'll breach the SLA. \<1.0 = we're under budget.
    </ResponseField>

    <ResponseField name="error_count" type="integer (int64)" required />

    <ResponseField name="error_rate" type="number (double)" required />

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

    <ResponseField name="health_checks" type="integer (int64)" required />

    <ResponseField name="health_failures" type="integer (int64)" required />

    <ResponseField name="latency_p50_ms" type="integer (int32)" required />

    <ResponseField name="latency_p95_ms" type="integer (int32)" required />

    <ResponseField name="latency_p99_ms" type="integer (int32)" required />

    <ResponseField name="observed_uptime" type="number (double)" required />

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

    <ResponseField name="target_uptime" type="number (double)" required />

    <ResponseField name="total_requests" type="integer (int64)" required />

    <ResponseField name="window_minutes" type="integer" required />
  </Expandable>
</ResponseField>

<ResponseField name="state" type="StatusState" required />

<ResponseField name="summary" type="string" required>
  Single human-readable summary for a status page.
</ResponseField>

<ResponseField name="version" type="string" required>
  Service version (Cargo package version).
</ResponseField>

### Status codes

| Code  | Meaning                                            |
| ----- | -------------------------------------------------- |
| `200` | Service status, SLA metrics, and dependency health |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.nsr.stateset.com/api/v1/status' \
    --header 'X-API-Key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "dependencies": [
      {
        "healthy": true,
        "latency_ms": 250,
        "name": "Two-Person Tent",
        "note": "Two-person tent, green — replacement for damaged pole set."
      }
    ],
    "generated_at": "2026-08-31T14:22:05Z",
    "incidents": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "opened_at": "2026-08-31T14:22:05Z",
        "severity": "string",
        "status": "pending",
        "title": "Replacement tent pole set"
      }
    ],
    "region": "CA",
    "sla": {
      "client_error_count": 1,
      "error_budget_burn_rate": 7.5,
      "error_count": 1,
      "error_rate": 7.5,
      "generated_at": "2026-08-31T14:22:05Z",
      "health_checks": 1,
      "health_failures": 1,
      "latency_p50_ms": 250,
      "latency_p95_ms": 250,
      "latency_p99_ms": 250,
      "observed_uptime": 1.5,
      "server_started_at": "2026-08-31T14:22:05Z",
      "target_uptime": 1.5,
      "total_requests": 1,
      "window_minutes": 1
    },
    "state": "operational",
    "summary": "Two-person tent, green — replacement for damaged pole set.",
    "version": "2026-08-01"
  }
  ```
</ResponseExample>