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.

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
IsFullClosure

True if all lanes are blocked for this event.

boolean
Comment

Extra information about the event

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
EventSubType

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

string
EncodedPolyline

A single string storing a series of coordinates. More information

string
Severity

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

string
Cause

Describes the cause of the event.

string

Response Formats

JSON

Sample: 
[
	{
		"ID": "ERS--277",
		"Organization": "ERS",
		"RoadwayName": "9th Ave",
		"DirectionOfTravel": "Unknown",
		"Description": "Minor accident on 9th Ave from Greentree Way to Mae Dr. ",
		"Reported": 1669746240,
		"LastUpdated": 1673987564,
		"StartDate": 1669746240,
		"PlannedEndDate": null,
		"LanesAffected": "No Data",
		"Latitude": 42.559393,
		"Longitude": -114.436539,
		"LatitudeSecondary": 42.55933,
		"LongitudeSecondary": -114.433022,
		"EventType": "accidentsAndIncidents",
		"IsFullClosure": false,
		"Comment": "detour is available ",
		"Restrictions": {
			"Width": 22.0,
			"Height": 10.0,
			"Length": null,
			"Weight": null,
			"Speed": 45.0
		},
		"DetourPolyline": "ekwbGj{myT?s@rCCh@Pf@^`@JnEAb@Kr@c@n@KvB@?eB???cB@qEm@?e@Qe@e@m@UcK?c@F]b@e@^aAFc@A",
		"DetourInstructions": [
			"Head toward Greentree Way on 9th Ave E. Go for 69 ft.",
			"Turn right onto Greentree Way. Go for 0.3 mi.",
			"Turn left onto Elizabeth Blvd. Go for 0.1 mi.",
			"Turn left onto Cypress Way. Go for 0.3 mi.",
			"Arrive at Cypress Way. Your destination is on the right."
		],
		"EventSubType": "minorAccident",
		"EncodedPolyline": "ekwbGj{myTBkMFsF",
		"Severity": "Unknown",
		"Cause": "Incident"
	},
	{
		"ID": "ERS--416",
		"Organization": "ERS",
		"RoadwayName": "W Prairie Ave",
		"DirectionOfTravel": "Eastbound",
		"Description": "Construction work on W Prairie Ave Eastbound from 1.01 Mi Before N Huetter Rd to N Huetter Rd.  1/11/2023 2:01 PM  Mon, Tue, Wed, Thu, Fri, Sat, Sun: Active all day",
		"Reported": 1673470860,
		"LastUpdated": 1674662801,
		"StartDate": 1673470860,
		"PlannedEndDate": null,
		"LanesAffected": "No Data",
		"Latitude": 47.74474,
		"Longitude": -116.87278,
		"LatitudeSecondary": 47.74482,
		"LongitudeSecondary": -116.85101,
		"EventType": "roadwork",
		"IsFullClosure": false,
		"Comment": null,
		"Restrictions": {
			"Width": null,
			"Height": null,
			"Length": null,
			"Weight": null,
			"Speed": null
		},
		"DetourPolyline": "sclbHzuihUkB?mHA}_@CiTAqVCA}JC}g@??A{MGia@CsZ?gEfC?hR@fT?`b@DzI?",
		"DetourInstructions": [
			"Head toward W Harvest Ave on N Meyer Rd. Go for 1.0 mi.",
			"Turn right onto W Hayden Ave. Go for 1.0 mi.",
			"Turn right onto N Huetter Rd. Go for 1.0 mi.",
			"Arrive at N Huetter Rd."
		],
		"EventSubType": "constructionWork",
		"EncodedPolyline": "sclbHzuihU?uGAmHCa`@CeVCqe@?cCAaI?}G",
		"RecurrenceSchedules": [
            {
                "StartDate": "1/11/2023 14:01:00 PM-07:00:00",
                "EndDate": null,
                "Times": [
                    {
                        "StartTime": "00:00:00-07:00:00",
                        "EndTime": "23:59:59-07:00:00"
                    }
                ],
                "DaysOfWeek": [
                    "Monday",
                    "Tuesday",
                    "Wednesday",
                    "Thursday",
                    "Friday",
                    "Saturday",
                    "Sunday"
                ]
            }
        ],
	}
]

XML

Sample: 
<EventList>
    <Event>
        <ID>ERS--277</ID>
        <Organization>ERS</Organization>
        <RoadwayName>9th Ave</RoadwayName>
        <DirectionOfTravel>Unknown</DirectionOfTravel>
        <Description>Minor accident on 9th Ave from Greentree Way to Mae Dr. </Description>
        <Reported>1669746240</Reported>
        <LastUpdated>1673987564</LastUpdated>
        <StartDate>1669746240</StartDate>
        <PlannedEndDate/>
        <LanesAffected>No Data</LanesAffected>
        <Latitude>42.559393</Latitude>
        <Longitude>-114.436539</Longitude>
        <LatitudeSecondary>42.55933</LatitudeSecondary>
        <LongitudeSecondary>-114.433022</LongitudeSecondary>
        <EventType>accidentsAndIncidents</EventType>
        <IsFullClosure>false</IsFullClosure>
        <Comment>detour is available </Comment>
        <Restrictions>
            <Width>22</Width>
            <Height>10</Height>
            <Length/>
            <Weight/>
            <Speed>45</Speed>
        </Restrictions>
        <DetourPolyline>ekwbGj{myT?s@rCCh@Pf@^`@JnEAb@Kr@c@n@KvB@?eB???cB@qEm@?e@Qe@e@m@UcK?c@F]b@e@^aAFc@A</DetourPolyline>
        <DetourInstructions>Head toward Greentree Way on 9th Ave E. Go for 69 ft. Turn right onto Greentree Way. Go for 0.3 mi. Turn left onto Elizabeth Blvd. Go for 0.1 mi. Turn left onto Cypress Way. Go for 0.3 mi. Arrive at Cypress Way. Your destination is on the right.</DetourInstructions>
        <EventSubType>minorAccident</EventSubType>
        <EncodedPolyline>ekwbGj{myTBkMFsF</EncodedPolyline>
	<Severity>Unknown</Severity>
        <Cause>Incident</Cause>
		
    </Event>
    <Event>
        <ID>ERS--416</ID>
        <Organization>ERS</Organization>
        <RoadwayName>W Prairie Ave</RoadwayName>
        <DirectionOfTravel>Eastbound</DirectionOfTravel>
        <Description>Construction work on W Prairie Ave Eastbound from 1.01 Mi Before N Huetter Rd to N Huetter Rd. 1/11/2023 2:01 PM Mon, Tue, Wed, Thu, Fri, Sat, Sun: Active all day</Description>
        <Reported>1673470860</Reported>
        <LastUpdated>1674662801</LastUpdated>
        <StartDate>1673470860</StartDate>
        <PlannedEndDate/>
        <LanesAffected>No Data</LanesAffected>
        <Latitude>47.74474</Latitude>
        <Longitude>-116.87278</Longitude>
        <LatitudeSecondary>47.74482</LatitudeSecondary>
        <LongitudeSecondary>-116.85101</LongitudeSecondary>
        <EventType>roadwork</EventType>
        <IsFullClosure>false</IsFullClosure>
        <Comment/>
        <Restrictions>
            <Width/>
            <Height/>
            <Length/>
            <Weight/>
            <Speed/>
        </Restrictions>
        <DetourPolyline>sclbHzuihUkB?mHA}_@CiTAqVCA}JC}g@??A{MGia@CsZ?gEfC?hR@fT?`b@DzI?</DetourPolyline>
        <DetourInstructions>Head toward W Harvest Ave on N Meyer Rd. Go for 1.0 mi. Turn right onto W Hayden Ave. Go for 1.0 mi. Turn right onto N Huetter Rd. Go for 1.0 mi. Arrive at N Huetter Rd.</DetourInstructions>
        <EventSubType>constructionWork</EventSubType>
        <EncodedPolyline>sclbHzuihU?uGAmHCa`@CeVCqe@?cCAaI?}G</EncodedPolyline>
	<RecurrenceSchedules>
            <Schedule>
                <StartDate>1/11/2023 14:01:00 PM-07:00:00</StartDate>
                <EndDate />
                <Times>
                    <Schedule>
                        <StartTime>00:00:00-07:00:00</StartTime>
                        <EndTime>23:59:59-07:00:00</EndTime>
                    </Schedule>
                </Times>
                <DaysOfWeek>Monday Tuesday Wednesday Thursday Friday Saturday Sunday</DaysOfWeek>
            </Schedule>
        </RecurrenceSchedules>
    </Event>
</EventList>