Verytis
Docs
API Status
ChangelogSupport

Road State

Verytis models road conditions using two independent state dimensions: declared state and observed state.

Declared States

Declared state comes from official or configured data sources — work zone feeds, temporary closure databases, traffic event APIs.

StateMeaning
openSource explicitly declares the road open
partially_closedOne or more lanes closed
closedFull road closure declared
restrictedRoad access is restricted
plannedA closure or restriction is planned but not yet active
unknownNo matching declared-state record was found

Observed States

Observed state comes from real-time signals — camera analysis, traffic flow patterns, temporal observations.

StateMeaning
normalNormal road activity observed
blockedRoad appears fully blocked
possibly_blockedPossible blockage detected
low_flowAbnormally low traffic flow
congestedHeavy congestion observed
obstructionPhysical obstruction detected
vehicles_stoppedVehicles appear stopped
unknownNo recent observation available
UNKNOWN does not mean OPEN.

If Verytis does not find an active closure in a configured declared-state source, the road is not automatically considered open. The declared state remains unknown.

This distinction is fundamental. It allows the system to surface possible information gaps when observed signals suggest abnormal road conditions but no declared closure exists in configured feeds.

Road State Endpoint

cURL
curl "https://verytis.com/api/v1/road-state?latitude=37.801&longitude=-122.456&radius=100" \
  -H "Authorization: Bearer $VERYTIS_API_KEY"
JSON
{
  "data": {
    "query": {
      "latitude": 37.801,
      "longitude": -122.456,
      "radius_meters": 100
    },
    "location": {
      "latitude": 37.801,
      "longitude": -122.456,
      "road_name": "Halleck Street"
    },
    "road_state": {
      "declared_state": "unknown",
      "observed_state": "possibly_blocked",
      "inferred_state": "possible_information_gap",
      "confidence": 0.91,
      "severity": 4,
      "action": "slow_verify",
      "reason": "A possible road-state information gap is active nearby.",
      "vehicle_usable": true
    },
    "freshness": {
      "updated_at": "2026-07-13T12:15:00.000Z",
      "ttl_seconds": 300,
      "source_freshness_seconds": 12
    },
    "display_lifecycle": {
      "live_map_ttl_seconds": 300,
      "removal_meaning": "not_fresh_enough_for_live_map_not_confirmed_resolved"
    },
    "location_quality": "official_coordinates",
    "events": [],
    "active_discrepancies": ["disc_..."],
    "updated_at": "..."
  },
  "meta": {
    "request_id": "req_..."
  }
}