Sources and Freshness

Verytis combines multiple source types. Every event and observation includes timestamps and provenance so you can evaluate data quality.

Source Types

TypeDescriptionExamples
declared_stateOfficial road status from public data sources511 WZDx, DataSF Temporary Street Closures, 511 Traffic Events
observed_stateReal-time signals from cameras and sensorsPublic camera feeds, traffic flow sensors

Timestamps

FieldMeaning
observed_atWhen the observation was captured
source_updated_atWhen the source last updated this record
ingested_atWhen Verytis ingested the record
freshness_secondsSeconds since the source was last successfully polled

Freshness and Staleness

Stale evidence receives lower weight in confidence calculations. A source is considered stale when:

  • Camera observations are older than 120 seconds
  • Traffic observations are older than 300 seconds
  • Declared events have not been refreshed within their poll interval

Sources Endpoint

GET /v1/sources
{
  "data": [
    {
      "id": "sf511_wzdx",
      "name": "511 WZDx",
      "type": "declared_state",
      "status": "online",
      "last_success_at": "2026-07-13T07:00:00Z",
      "freshness_seconds": 34,
      "poll_interval_seconds": 60
    },
    {
      "id": "datasf_temporary_closures",
      "name": "DataSF Temporary Street Closures",
      "type": "declared_state",
      "status": "online",
      "last_success_at": "2026-07-13T06:55:00Z",
      "freshness_seconds": 334,
      "poll_interval_seconds": 300
    }
  ],
  "meta": {
    "request_id": "req_..."
  }
}