API Documentation Home

GET Events

Returns all traffic events.

Request Information

https://nc.prod.traveliq.co//api/v2/get/event

URI Parameters

URI Parameters
Name	Description	Type	Additional information
key	Developer Key	string	Required
format	Valid values are 'xml' or 'json', default 'json'.	string	Optional

Response Information

Resource Description

Resource Description
Name	Description	Type
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
MajorEvent	Type of Major Event	string

Response Formats

JSON

Sample:

<EventList>
	<Event>
		<ID>42178</ID>
		<SourceId>2</SourceId>
		<Organization>ATMSERS</Organization>
		<RoadwayName>I-73</RoadwayName>
		<DirectionOfTravel>North</DirectionOfTravel>
		<Description>Crash on I-73 Northbound near Black Ankle Road. 1 Right lane closed.</Description>
		<Reported>1731967860</Reported>
		<LastUpdated>1731967974</LastUpdated>
		<StartDate>1731967860</StartDate>
		<PlannedEndDate/>
		<LanesAffected>1 Right lane closed</LanesAffected>
		<Latitude>35.4789481296189</Latitude>
		<Longitude>-79.7821554869982</Longitude>
		<LatitudeSecondary/>
		<LongitudeSecondary/>
		<EventType>accidentsAndIncidents</EventType>
		<EventSubType>crash</EventSubType>
		<IsFullClosure>false</IsFullClosure>
		<Severity>Minor</Severity>
		<Comment/>
		<EncodedPolyline/>
		<Restrictions>
			<Width/>
			<Height/>
			<Length/>
			<Weight/>
			<Speed/>
		</Restrictions>
		<DetourPolyline/>
		<DetourInstructions/>
		<Recurrence/>
		<RecurrenceSchedules/>
		<MajorEvent>HURRICANE HELENE</MajorEvent>
	</Event>
	<Event>
		<ID>42179</ID>
		<SourceId>3</SourceId>
		<Organization>ATMSERS</Organization>
		<RoadwayName>I-85</RoadwayName>
		<DirectionOfTravel>South</DirectionOfTravel>
		<Description>Vehicle Crash on I-85 Southbound near High Rock Lake. All lanes closed.</Description>
		<Reported>1733249520</Reported>
		<LastUpdated>1742324386</LastUpdated>
		<StartDate>1733249520</StartDate>
		<PlannedEndDate/>
		<LanesAffected>All lanes closed</LanesAffected>
		<Latitude>35.760561396687</Latitude>
		<Longitude>-80.3409674440933</Longitude>
		<LatitudeSecondary/>
		<LongitudeSecondary/>
		<EventType>closures</EventType>
		<EventSubType>vehicleCrash</EventSubType>
		<IsFullClosure>true</IsFullClosure>
		<Severity>Major</Severity>
		<Comment>detour is available. </Comment>
		<EncodedPolyline/>
		<Restrictions>
			<Width/>
			<Height/>
			<Length/>
			<Weight/>
			<Speed/>
		</Restrictions>
		<DetourPolyline/>
		<DetourInstructions/>
		<Recurrence/>
		<RecurrenceSchedules/>
		<MajorEvent/>
	</Event>
</EventList>

XML

Sample:

<EventList>
	<Event>
		<ID>42178</ID>
		<SourceId>2</SourceId>
		<Organization>ATMSERS</Organization>
		<RoadwayName>I-73</RoadwayName>
		<DirectionOfTravel>North</DirectionOfTravel>
		<Description>Crash on I-73 Northbound near Black Ankle Road. 1 Right lane closed.</Description>
		<Reported>1731967860</Reported>
		<LastUpdated>1731967974</LastUpdated>
		<StartDate>1731967860</StartDate>
		<PlannedEndDate/>
		<LanesAffected>1 Right lane closed</LanesAffected>
		<Latitude>35.4789481296189</Latitude>
		<Longitude>-79.7821554869982</Longitude>
		<LatitudeSecondary/>
		<LongitudeSecondary/>
		<EventType>accidentsAndIncidents</EventType>
		<EventSubType>crash</EventSubType>
		<IsFullClosure>false</IsFullClosure>
		<Severity>Minor</Severity>
		<Comment/>
		<EncodedPolyline/>
		<Restrictions>
			<Width/>
			<Height/>
			<Length/>
			<Weight/>
			<Speed/>
		</Restrictions>
		<DetourPolyline/>
		<DetourInstructions/>
		<Recurrence/>
		<RecurrenceSchedules/>
		<MajorEvent>HURRICANE HELENE</MajorEvent>
	</Event>
	<Event>
		<ID>42179</ID>
		<SourceId>3</SourceId>
		<Organization>ATMSERS</Organization>
		<RoadwayName>I-85</RoadwayName>
		<DirectionOfTravel>South</DirectionOfTravel>
		<Description>Vehicle Crash on I-85 Southbound near High Rock Lake. All lanes closed.</Description>
		<Reported>1733249520</Reported>
		<LastUpdated>1742324386</LastUpdated>
		<StartDate>1733249520</StartDate>
		<PlannedEndDate/>
		<LanesAffected>All lanes closed</LanesAffected>
		<Latitude>35.760561396687</Latitude>
		<Longitude>-80.3409674440933</Longitude>
		<LatitudeSecondary/>
		<LongitudeSecondary/>
		<EventType>closures</EventType>
		<EventSubType>vehicleCrash</EventSubType>
		<IsFullClosure>true</IsFullClosure>
		<Severity>Major</Severity>
		<Comment>detour is available. </Comment>
		<EncodedPolyline/>
		<Restrictions>
			<Width/>
			<Height/>
			<Length/>
			<Weight/>
			<Speed/>
		</Restrictions>
		<DetourPolyline/>
		<DetourInstructions/>
		<Recurrence/>
		<RecurrenceSchedules/>
		<MajorEvent/>
	</Event>
</EventList>