Events
Events are normalized road records from configured declared-state sources. Every event includes source provenance.
List Events
cURL
curl "https://verytis.com/api/v1/events?latitude=37.8&longitude=-122.45&radius=5000" \
-H "Authorization: Bearer $VERYTIS_API_KEY"Query Parameters
| Parameter | Type | Description |
|---|---|---|
source | string | Filter by source slug |
event_type | string | Filter by event type |
latitude | number | Center latitude |
longitude | number | Center longitude |
radius | number | Radius in meters |
since | string | ISO 8601 lower bound |
until | string | ISO 8601 upper bound |
limit | integer | Max results (default 250, max 500) |
Event Types
| Type | Description |
|---|---|
closure | Full road closure |
lane_closure | One or more lanes closed |
construction | Construction activity |
collision | Collision reported |
hazard | Road hazard |
congestion | Congestion event |
detour | Detour in effect |
special_event | Special event affecting road |
Single Event
GET /v1/events/:id
{
"data": {
"id": "...",
"event_type": "closure",
"title": "Road Closure - Halleck Street",
"road_name": "Halleck Street",
"declared_status": "closed",
"location": {
"latitude": 37.801,
"longitude": -122.456
},
"start_time": "2026-07-13T06:00:00Z",
"end_time": null,
"source": {
"id": "sf511_wzdx",
"name": "511 WZDx",
"type": "declared_state"
},
"freshness_seconds": 45
},
"meta": {
"request_id": "req_..."
}
}