---
title: "Canonical operational state + source findings"
method: GET
path: "/api/v1/status"
tags: ["Health"]
---

# Canonical operational state + source findings

`GET /api/v1/status`

## Request

- Base URL: `https://fonteum.com`
- URL: `https://fonteum.com/api/v1/status`
- Auth: none required

Public endpoint (moat-defense #125). `data.summary.overall` and `data.operational_state.overall` are the shared canonical operational state. Its four dimensions separate transport uptime, pipeline freshness, source completeness, and incidents. `summary.findings_state` is a narrower source-report finding for the records represented here; it is not a second service headline. Per-source fields do not establish upstream freshness for omitted sources, and partial ledger reads remain explicit in availability flags.

## Response `200`

Source-status report.

- object
  - `data` object
    - `availability` object, required
      - `registry` boolean, required
      - `snapshots` boolean, required
      - `crosswalk` boolean, required: Whether the durable registry-to-snapshot source-key crosswalk was readable for this report.
      - `drift` boolean, required
      - `quarantine` boolean, required
      - `health` boolean, required
    - `summary` object, required
      - `overall` 'operational' | 'degraded' | 'outage' | 'unknown', required: Canonical operational headline shared by health and status endpoints. It is derived from separately reported transport, pipeline, source-completeness, and incident dimensions.
      - `findings_state` 'ok' | 'attention', required
      - `total_sources` integer
      - `current` integer
      - `degraded` integer
      - `stale` integer
      - `unknown` integer
      - `sources_with_open_drift` integer
      - `sources_quarantined` integer
      - `sources_degraded_upstream` integer
      - `sources_with_evidence_error` integer
    - `operational_state` OperationalStatus, required: One dated operational assessment. Transport reachability, pipeline freshness, source completeness, and incidents remain separate so a data concern is not represented as a transport outage.
      - `overall` 'operational' | 'degraded' | 'outage' | 'unknown', required: Canonical operational headline shared by health and status endpoints. It is derived from separately reported transport, pipeline, source-completeness, and incident dimensions.
      - `generated_at` string, date-time, required
      - `transport` object, required
        - `state` 'operational' | 'degraded' | 'outage' | 'unknown', required: Canonical operational headline shared by health and status endpoints. It is derived from separately reported transport, pipeline, source-completeness, and incident dimensions.
        - `monitored_endpoint` string, required
        - `uptime_24h_pct` number, nullable, required
        - `uptime_30d_pct` number, nullable, required
      - `pipeline_freshness` object, required
        - `state` 'current' | 'degraded' | 'unknown', required
        - `current_sources` integer, required
        - `degraded_sources` integer, required
        - `stale_sources` integer, required
        - `legacy_unknown_sources` integer, required
        - `legacy_failed_sources` integer, required
      - `source_completeness` object, required
        - `state` 'complete' | 'incomplete' | 'unknown', required
        - `total_sources` integer, required
        - `observed_sources` integer, required
        - `unknown_sources` integer, required
        - `quality_status` 'current' | 'incomplete' | 'unavailable', required
        - `quality_score` number, nullable, required
      - `incidents` object, required
        - `state` 'clear' | 'active' | 'unknown', required
        - `open_count` integer, required
        - `highest_severity` 'critical' | 'error' | 'warning', nullable, required
        - `schema_drift_sources` integer, required
        - `quarantined_sources` integer, required
        - `upstream_degraded_sources` integer, required
        - `evidence_error_sources` integer, required
        - `operations_status` 'green' | 'red' | 'unobservable' | 'never-run' | 'unavailable', required
    - `sources` object[], required
  - `provenance` object
  - `meta` object

---

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