GET Events

Returns all traffic events.

Request Information

https://nc.prod.traveliq.co//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
MajorEvent

Type of Major Event

string

Response Formats

JSON

Sample: 
[
  {
    "ID": 42178,
    "SourceId": "2",
    "Organization": "ATMSERS",
    "RoadwayName": "I-73",
    "DirectionOfTravel": "Northbound",
    "Description": "Crash on I-73 Northbound near Black Ankle Road. 1 Right lane closed.",
    "Reported": 1731967860,
    "LastUpdated": 1731967974,
    "StartDate": 1731967860,
    "PlannedEndDate": null,
    "LanesAffected": "1 Right lane closed",
    "Latitude": 35.4789481296189,
    "Longitude": -79.7821554869982,
    "LatitudeSecondary": null,
    "LongitudeSecondary": null,
    "EventType": "accidentsAndIncidents",
    "EventSubType": "crash",
    "IsFullClosure": false,
    "Severity": "Minor",
    "Comment": null,
    "EncodedPolyline": null,
    "Restrictions": {
      "Width": null,
      "Height": null,
      "Length": null,
      "Weight": null,
      "Speed": null
    },
    "DetourPolyline": "",
    "DetourInstructions": "",
    "Recurrence": "",
    "RecurrenceSchedules": "",
    "MajorEvent": null
  },
  {
    "ID": 42179,
    "SourceId": "3",
    "Organization": "ATMSERS",
    "RoadwayName": "I-85",
    "DirectionOfTravel": "Southbound",
    "Description": "Vehicle Crash on I-85 Southbound near High Rock Lake. All lanes closed.",
    "Reported": 1733249520,
    "LastUpdated": 1742324386,
    "StartDate": 1733249520,
    "PlannedEndDate": null,
    "LanesAffected": "All lanes closed",
    "Latitude": 35.760561396687,
    "Longitude": -80.3409674440933,
    "LatitudeSecondary": null,
    "LongitudeSecondary": null,
    "EventType": "closures",
    "EventSubType": "vehicleCrash",
    "IsFullClosure": true,
    "Severity": "Major",
    "Comment": "detour is available. ",
    "EncodedPolyline": null,
    "Restrictions": {
      "Width": null,
      "Height": null,
      "Length": null,
      "Weight": null,
      "Speed": null
    },
    "DetourPolyline": "}afyEr`liNz@vAN^Hl@Al@G`@M`@Yf@_@\\SHQBK@YA[CGAa@CgBwBnBuCFKpAqBb@o@t@mAr@kA|AoCvA~ARx@BLBN@J@P?FATALAHCLCJCHEJEHILIJIHIFKFOFIBE@G@M@I?UCKCMEWK_@QWMUMWYeIwIiEqEmKeL}EgFsJ}JiBmB_@a@kAsAw@_As@aAgAwAg@u@oAiB_DwEcDwEyBcDwAoBc@o@_DwEs@gAcA_By@kA{AyB}BgD}@uAgAkBy@_Bg@gA{@sB[{@w@eCSu@U_AQw@a@sB[iBe@wCGc@McAk@kE}ByPGg@QoAOqEEgD?YD{FBeBC{@iBLmBJiDD@dADx@D^F`@Lb@Nb@Rb@LT~@xAZf@Zj@Xj@Xp@Vp@Rv@hAbF",
    "DetourInstructions": [
      "Take ramp. Go for 0.2 mi.",
      "Turn right onto Belmont Rd (NC-47). Go for 0.2 mi.",
      "Turn right and take ramp onto I-85 N toward Lexington/US-29 N/US-52 N/US-70 E. Go for 2.4 mi.",
      "Take exit 88 toward NC-47/Hargrave Rd. Go for 0.2 mi.",
      "Turn left onto Hargrave Rd. Go for 0.1 mi.",
      "Turn left and take ramp toward I-85 S/Charlotte. Go for 0.3 mi.",
      "Arrive at your destination."
    ],
    "Recurrence": "",
    "RecurrenceSchedules": "",
    "MajorEvent": null
  }
]

XML

Sample: 
<EventList>
	<Event>
		<ID>42178</ID>
		<SourceId>2</SourceId>
		<Organization>ATMSERS</Organization>
		<RoadwayName>I-73</RoadwayName>
		<DirectionOfTravel>Northbound</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>Southbound</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>