---
title: "The Traffic Incident API provides traffic incidents like construction, traffic
congestion and accidents, etc. within a bounding box. It also provides traffic
metadata for detailed information about each incident."
method: GET
path: "/traffic/incident"
---

# The Traffic Incident API provides traffic incidents like construction, traffic
congestion and accidents, etc. within a bounding box. It also provides traffic
metadata for detailed information about each incident.

`GET /traffic/incident`

The API provides a GeoJSON feature collection of traffic incidents. Each
incident includes two point features: the location where you encounter the
incident and the end location of a traffic incident like the end of a
construction zone. For traffic incident coverage by country/region, see
[traffic
coverage](https://learn.microsoft.com/azure/azure-maps/traffic-coverage?pivots=latest).

## Query parameters

- `api-version` string, required
- `incidentType` 'Accident' | 'Congestion' | 'DisabledVehicle' | 'Miscellaneous' | 'RoadHazard' | 'Construction' | 'Weather'
- `bbox` number[], required

## Headers

- `x-ms-client-id` string
- `Accept-Language` string

## Response `200`

The request has succeeded.

- TrafficIncidentResponse — A GeoJSON feature collection object that contains a list of traffic incidents features.
  - `type` 'FeatureCollection' — Specifies the `GeoJSON` type. The only supported object type is `FeatureCollection`. For more information, see [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946).
  - `features` TrafficIncidentFeaturesItem[] — `GeoJSON` feature object that contains Geometry object and additional properties. Refer to [RFC 7946, Section 3.2](https://www.rfc-editor.org/rfc/rfc7946#section-3.2) for details.
    - `type` 'Feature' — Specifies the `GeoJSON` type. The only supported object type is Feature. For more information, see [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946).
    - `id` integer — A unique ID for the incident.
    - `geometry` GeoJsonPoint — A valid `GeoJSON` geometry object. The type must be one of the seven valid GeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon and GeometryCollection. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details.
      - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'GeometryCollection' | 'Feature' | 'FeatureCollection', required — Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.
      - `bbox` number[] — Bounding box. Projection used - EPSG:3857. Please refer to [RFC 7946](https://datatracker.ietf.org/doc/html/rfc7946#section-5) for details.
    - `properties` TrafficIncidentFeatureProperties — Specifies detailed information about the traffic incidents.
      - `description` string — A description of the incident that includes the road name and the event impacting the traffic flow. Examples: • W 95th St between Switzer Rd and Bluejacket Dr - construction • WB Johnson Dr at I-435 - bridge repair
      - `startTime` string — The date and time in UTC when the incident occurred, formatted as a dateTime value as defined in [RFC 3339, section 5.6](https://www.rfc-editor.org/rfc/rfc3339#section-5.6).
      - `endTime` string — The date and time in UTC when the traffic incident will end, formatted as a dateTime value as defined in [RFC 3339, section 5.6](https://www.rfc-editor.org/rfc/rfc3339#section-5.6).
      - `lastModifiedTime` string — The date and time in UTC when the incident information was last updated, formatted as a dateTime value as defined in [RFC 3339, section 5.6](https://www.rfc-editor.org/rfc/rfc3339#section-5.6).
      - `isRoadClosed` boolean — A value of `true` indicates that there is a road closure.
      - `severity` integer — Specifies the level of importance of the incident. - 0: Unknown - 1: Minor - 2: Moderate - 3: Major - 4: Undefined (used for road closures and other indefinite delays)
      - `incidentType` 'Accident' | 'Congestion' | 'DisabledVehicle' | 'Miscellaneous' | 'RoadHazard' | 'Construction' | 'Weather' — Specifies the type of traffic incident. This can be used to request and differentiate between various types of incidents.
      - `title` string — Specifies the road names and direction of affected roads.
      - `delay` number, double — The delay caused by the incident in seconds. If no delay or not applicable, it returns zero.
      - `endPoint` object — A GeoJson Point object that specified the end location of a traffic incident such as end of a construction zone. This location is part of the incident properties object and by default, cannot be interpreted by parsers for display on the map.
      - `isTrafficJam` boolean — A value of `true` indicates that the area of road covered by this incident is experiencing abnormal traffic conditions resulting in non-typical delays.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (1.0) `6b1ffaa8c256` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/maps-traffic/changes/traffic/incident/get.md)

---

[API](https://skmtc.dev/azure/apis/maps-traffic.md) · [All operations](https://skmtc.dev/azure/apis/maps-traffic/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/maps-traffic/revisions/6b1ffaa8c256/schema)