---
title: "Service status and SLOs"
method: GET
path: "/api/v1/status"
tags: ["Status"]
---

# Service status and SLOs

`GET /api/v1/status`

## Request

- Base URL: `https://www.snowsure.ai`
- URL: `https://www.snowsure.ai/api/v1/status`
- Auth: none required

Machine-readable status over a sample of resorts: the integrity SLO (share of reliability checks passing, target ≥ 0.95) and the freshness SLO (share of live fields gone stale, target ≤ 0.10), each with whether it is met. Answers 200 when degraded — read `status` and `slo.*.met`. A 503 means the status check itself failed.

**Auth:** none.

**Caching:** `Cache-Control: public, s-maxage=300, stale-while-revalidate=600` (Vercel CDN, 5 minutes).

## Query parameters

- `limit` integer

## Response `200`

Status contract (operational or degraded)

- StatusResponse
  - `status` 'operational' | 'degraded', required
  - `generatedAt` string, date-time, required
  - `slo` object
    - `integrity` StatusSloMetric
      - `metric` string
      - `value` number
      - `target` number
      - `comparator` 'gte' | 'lte'
      - `met` boolean
      - `description` string
    - `freshness` StatusSloMetric
      - `metric` string
      - `value` number
      - `target` number
      - `comparator` 'gte' | 'lte'
      - `met` boolean
      - `description` string
  - `checks` object[]
    - `check` string
    - `passRate` number
  - `sample` object
    - `sampled` integer
    - `resolved` integer
  - `scrape` object: Where the displayed depth came from across the sample, and scraper total mismatches.
    - `sampled` integer
    - `bySource` object
      - `operator` integer
      - `scraped` integer
      - `model` integer
      - `none` integer
    - `scraped` object
      - `total` integer
      - `fresh` integer
      - `stale` integer
      - `freshShare` number
    - `coverageShare` number
    - `totalMismatch` object
      - `lifts` integer
      - `runs` integer
      - `resorts` string[]
  - `issues` string[], required: Empty when operational.

## Other responses

- `503`: The status check failed

---

[API](https://skmtc.dev/snowsure/apis/snowsure-api.md) · [All operations](https://skmtc.dev/snowsure/apis/snowsure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snowsure/apis/snowsure-api/revisions/dcbcdbb3df50?raw)