GET Events

Returns all traffic events.

Request Information

https://511.idaho.gov/api/v2/get/event

URI Parameters

URI Parameters
NameDescriptionTypeAdditional information
key

Developer Key

 string

Required
format

Valid values are 'xml' or 'json', default 'json'.

 string

Optional

Response Information

Resource Description


Resource Description
NameDescriptionType
ID

A unique identifier.

integer
SourceId

The source id of the event.

string
Organization

The name of the organization that provided this event.

string
RoadwayName

The roadway on which the event occurred.

string
DirectionOfTravel

One of the following directions of travel: None, All Directions, Northbound, Eastbound, Southbound, Westbound, Inbound, Outbound, Both Directions.

string
Description

A summary of the event details which often includes type of event, dates and lanes affected.

string
Reported

The date the event was reported in Unix time. More information

integer
LastUpdated

The date the event's details were last updated in Unix time. More information

integer
StartDate

The start date of the event in Unix time. More information

integer
PlannedEndDate

The date the event is expected to end in Unix time. More information

integer
LanesAffected

Describes the lane or number of lanes affected by the event. For example: all lanes.

string
Latitude

The latitude describing the location. Format: double between -90 and 90.

double
Longitude

The longitude describing the location. Format: double between -180 and 180.

double
LatitudeSecondary

Secondary latitude.

double
LongitudeSecondary

Secondary Longitude.

double
EventType

The type of event. One of the following: roadwork, closures or accidentsAndIncidents.

string
EventSubType

A more detailed and descriptive event type. No fixed list of sub types.

string
IsFullClosure

True if all lanes are blocked for this event.

boolean
Severity

Describes the severity of the event with default value of Unknown.

string
Comment

Extra information about the event

string
EncodedPolyline

A single string storing a series of coordinates. More information

string
Restrictions

Different types of restriction: Width (Feet), Height (Feet), Weight (Tons) and Speed (Mph).

list
DetourPolyline

Google Encoded Polyline for the detour

string
DetourInstructions

Turn by turn instructions for the detour

string
Recurrence

Describes the schedule of the event.

string
RecurrenceSchedules

More information about recurring events. Event start and end dates, times and day(s) of the week event is active.

string
Cause

Describes the cause of the event.

string

Response Formats

JSON

Sample: 
[
 {
        "ID": 5,
        "SourceId": "902",
        "Organization": "ERS",
        "RoadwayName": "SH-55",
        "DirectionOfTravel": "Both",
        "Description": " Road construction on SH-55 Both Directions from King Hill Ln to NF-644. 8/14/2023 10:10 AM Mon, Tue, Wed, Thu, Fri, Sat, Sun: Active all day",
        "Reported": 1692029400,
        "LastUpdated": 1691769666,
        "StartDate": 1692029400,
        "PlannedEndDate": null,
        "LanesAffected": "No Data",
        "Latitude": 44.2661422976652,
        "Longitude": -116.070720084873,
        "LatitudeSecondary": 44.2657600881049,
        "LongitudeSecondary": -116.070220140968,
        "EventType": "roadwork",
        "EventSubType": "roadConstruction",
        "IsFullClosure": false,
        "Severity": "None",
        "Comment": null,
        "EncodedPolyline": "kvdmG~`mcUZ_@Zc@R_@",
        "Restrictions": {
            "Width": null,
            "Height": null,
            "Length": null,
            "Weight": null,
            "Speed": null
        },
        "DetourPolyline": null,
        "DetourInstructions": null,
        "Recurrence": "<b>Mon, Tue, Wed, Thu, Fri, Sat, Sun:</b><br/>Active all day<br/><br/>",
        "RecurrenceSchedules": [
            {
                "StartDate": "8/14/2023 10:10:00 AM-06:00:00",
                "EndDate": null,
                "Times": [
                    {
                        "StartTime": "00:00:00-06:00:00",
                        "EndTime": "23:59:59-06:00:00"
                    }
                ],
                "DaysOfWeek": [
                    "Monday",
                    "Tuesday",
                    "Wednesday",
                    "Thursday",
                    "Friday",
                    "Saturday",
                    "Sunday"
                ]
            }
        ],
        "Cause": "roadwork"
    }
]

XML

Sample: 
<Event>
        <ID>5</ID>
        <SourceId>902</SourceId>
        <Organization>ERS</Organization>
        <RoadwayName>SH-55</RoadwayName>
        <DirectionOfTravel>Both</DirectionOfTravel>
        <Description> Road construction on SH-55 Both Directions from King Hill Ln to NF-644. 8/14/2023 10:10 AM Mon, Tue, Wed, Thu, Fri, Sat, Sun: Active all day</Description>
        <Reported>1692029400</Reported>
        <LastUpdated>1691769666</LastUpdated>
        <StartDate>1692029400</StartDate>
        <PlannedEndDate />
        <LanesAffected>No Data</LanesAffected>
        <Latitude>44.2661422976652</Latitude>
        <Longitude>-116.070720084873</Longitude>
        <LatitudeSecondary>44.2657600881049</LatitudeSecondary>
        <LongitudeSecondary>-116.070220140968</LongitudeSecondary>
        <EventType>roadwork</EventType>
        <EventSubType>roadConstruction</EventSubType>
        <IsFullClosure>false</IsFullClosure>
        <Severity>None</Severity>
        <Comment />
        <EncodedPolyline>kvdmG~`mcUZ_@Zc@R_@</EncodedPolyline>
        <Restrictions>
            <Width />
            <Height />
            <Length />
            <Weight />
            <Speed />
        </Restrictions>
        <DetourPolyline />
        <DetourInstructions />
        <Recurrence>&lt;b&gt;Mon, Tue, Wed, Thu, Fri, Sat, Sun:&lt;/b&gt;&lt;br/&gt;Active all day&lt;br/&gt;&lt;br/&gt;</Recurrence>
        <RecurrenceSchedules>
            <Schedule>
                <StartDate>8/14/2023 10:10:00 AM-06:00:00</StartDate>
                <EndDate />
                <Times>
                    <Schedule>
                        <StartTime>00:00:00-06:00:00</StartTime>
                        <EndTime>23:59:59-06:00:00</EndTime>
                    </Schedule>
                </Times>
                <DaysOfWeek>Monday Tuesday Wednesday Thursday Friday Saturday Sunday</DaysOfWeek>
            </Schedule>
        </RecurrenceSchedules>
        <Cause>roadwork</Cause>
    </Event>