Status

Get measured source and bulk-snapshot state.

The endpoint to poll before trusting a freshness-sensitive read. status is operational only when every check passes; otherwise it is degraded and degraded_reasons names each failing check alongside the measurement that failed it, including the observed value and the threshold it was tested against. A degraded status describes source freshness and pipeline completeness; it does not mean the API is refusing requests, and served rows remain the last good measured state rather than being withheld. institutional_delivery.available is a separate commercial gate and is not implied by operational. Accepts no query parameters.

get/api/v1/status

Request

  • Base URL: https://www.veridionmarkets.com
  • URL: https://www.veridionmarkets.com/api/v1/status
  • Auth: one of:
    • none
    • HTTP bearer

Response

Current measured state.

version'1.21.0' required

The contract version this response was produced under; the same value as X-API-Version.

generated_atstring date-time required

When this response was computed. Every age_seconds below is measured from this instant, so the block is internally consistent even when read from a cache.

state'ready' | 'degraded' | 'unavailable' required

ready when no check below is failing. degraded when any source is stale or unavailable, the export is stale, unavailable or missing its merkle_root, coverage recovery is stale or unavailable, the Congress summary is stale, unavailable or unattested, a temporal-conformance contract fails, the temporal window is unreadable, the House index lists unaccounted filings, or a pipeline job is not delivering. unavailable when the status itself could not be measured. The endpoint never reports a state more optimistic than its own arithmetic: a stored 'ready' older than its threshold is reported stale.

detailstring

Present only on the unavailable body, naming what could not be read.

noticestring

Standing guidance on reading this block: what no_data means, what degraded does and does not imply, and how to verify a download.

Changes

No recorded changes to this operation across all 1 revision of this API.