---
title: "Get active disruptions, filtered by road ids"
method: GET
path: "/Road/{ids}/Disruption"
tags: ["Road"]
---

# Get active disruptions, filtered by road ids

`GET /Road/{ids}/Disruption`

## Path parameters

- `ids` string[], required

## Query parameters

- `stripContent` boolean
- `severities` string[]
- `categories` string[]
- `closures` boolean

## Response `200`

OK

- TflApiPresentationEntitiesRoadDisruption[]
  - `id` string — Unique identifier for the road disruption
  - `url` string — URL to retrieve this road disruption
  - `point` string — Latitude and longitude (WGS84) of the centroid of the disruption, stored in a geoJSON-formatted string.
  - `severity` string — A description of the severity of the disruption.
  - `ordinal` integer — An ordinal of the disruption based on severity, level of interest and corridor.
  - `category` string — Describes the nature of disruption e.g. Traffic Incidents, Works
  - `subCategory` string — Describes the sub-category of disruption e.g. Collapsed Manhole, Abnormal Load
  - `comments` string — Full text of comments describing the disruption, including details of any road closures and diversions, where appropriate.
  - `currentUpdate` string — Text of the most recent update from the LSTCC on the state of the disruption, including the current traffic impact and any advice to road users.
  - `currentUpdateDateTime` string, date-time — The time when the last CurrentUpdate description was recorded, or null if no CurrentUpdate has been applied.
  - `corridorIds` string[] — The Ids of affected corridors, if any.
  - `startDateTime` string, date-time — The date and time which the disruption started. For a planned disruption (i.e. planned road works) this date will be in the future. For unplanned disruptions, this will default to the date on which the disruption was first recorded, but may be adjusted by the operator.
  - `endDateTime` string, date-time — The date and time on which the disruption ended. For planned disruptions, this date will have a valid value. For unplanned disruptions in progress, this field will be omitted.
  - `lastModifiedTime` string, date-time — The date and time on which the disruption was last modified in the system. This information can reliably be used by a developer to quickly compare two instances of the same disruption to determine if it has been changed.
  - `levelOfInterest` string — This describes the level of potential impact on traffic operations of the disruption. High = e.g. a one-off disruption on a major or high profile route which will require a high level of operational attention Medium = This is the default value Low = e.g. a frequently occurring disruption which is well known
  - `location` string — Main road name / number (borough) or preset area name where the disruption is located. This might be useful for a map popup where space is limited.
  - `status` string — This describes the status of the disruption. Active = currently in progress Active Long Term = currently in progress and long term Scheduled = scheduled to start within the next 180 days Recurring Works = planned maintenance works that follow a regular routine or pattern and whose next occurrence is to start within the next 180 days. Recently Cleared = recently cleared in the last 24 hours Note that the status of Scheduled or Recurring Works disruptions will change to Active when they start, and will change status again when they end.
  - `geography` SystemDataSpatialDbGeography
    - `geography` SystemDataSpatialDbGeographyWellKnownValue
      - `coordinateSystemId` integer
      - `wellKnownText` string
      - `wellKnownBinary` string, byte
  - `geometry` SystemDataSpatialDbGeography
    - `geography` SystemDataSpatialDbGeographyWellKnownValue
      - `coordinateSystemId` integer
      - `wellKnownText` string
      - `wellKnownBinary` string, byte
  - `streets` TflApiPresentationEntitiesStreet[] — A collection of zero or more streets affected by the disruption.
    - `name` string — Street name
    - `closure` string — Type of road closure. Some example values: Open = road is open, not blocked, not closed, not restricted. It maybe that the disruption has been moved out of the carriageway. Partial Closure = road is partially blocked, closed or restricted. Full Closure = road is fully blocked or closed.
    - `directions` string — The direction of the disruption on the street. Some example values: All Directions All Approaches Clockwise Anti-Clockwise Northbound Eastbound Southbound Westbound Both Directions
    - `segments` TflApiPresentationEntitiesStreetSegment[] — Geographic description of the sections of this street that are affected.
      - `toid` string — A 16 digit unique integer identifying a OS ITN (Ordnance Survey Integrated Transport Network) road link.
      - `lineString` string — geoJSON formatted LineString containing two latitude/longitude (WGS84) pairs that identify the start and end points of the street segment.
      - `sourceSystemId` integer — The ID from the source system of the disruption that this street belongs to.
      - `sourceSystemKey` string — The key of the source system of the disruption that this street belongs to.
    - `sourceSystemId` integer — The ID from the source system of the disruption that this street belongs to.
    - `sourceSystemKey` string — The key of the source system of the disruption that this street belongs to.
  - `isProvisional` boolean — True if the disruption is planned on a future date that is open to change
  - `hasClosures` boolean — True if any of the affected Streets have a "Full Closure" status, false otherwise. A RoadDisruption that has HasClosures is considered a Severe or Serious disruption for severity filtering purposes.
  - `linkText` string — The text of any associated link
  - `linkUrl` string — The url of any associated link
  - `roadProject` TflApiPresentationEntitiesRoadProject
    - `projectId` string
    - `schemeName` string
    - `projectName` string
    - `projectDescription` string
    - `projectPageUrl` string
    - `consultationPageUrl` string
    - `consultationStartDate` string, date-time
    - `consultationEndDate` string, date-time
    - `constructionStartDate` string, date-time
    - `constructionEndDate` string, date-time
    - `boroughsBenefited` string[]
    - `cycleSuperhighwayId` string
    - `phase` 'Unscoped' | 'Concept' | 'ConsultationEnded' | 'Consultation' | 'Construction' | 'Complete'
    - `contactName` string
    - `contactEmail` string
    - `externalPageUrl` string
    - `projectSummaryPageUrl` string
  - `publishStartDate` string, date-time — TDM Additional properties
  - `publishEndDate` string, date-time
  - `timeFrame` string
  - `roadDisruptionLines` TflApiPresentationEntitiesRoadDisruptionLine[]
    - `id` integer
    - `roadDisruptionId` string
    - `isDiversion` boolean
    - `multiLineString` SystemDataSpatialDbGeography
      - `geography` SystemDataSpatialDbGeographyWellKnownValue
        - `coordinateSystemId` integer
        - `wellKnownText` string
        - `wellKnownBinary` string, byte
    - `startDate` string, date-time
    - `endDate` string, date-time
    - `startTime` string
    - `endTime` string
  - `roadDisruptionImpactAreas` TflApiPresentationEntitiesRoadDisruptionImpactArea[]
    - `id` integer
    - `roadDisruptionId` string
    - `polygon` SystemDataSpatialDbGeography
      - `geography` SystemDataSpatialDbGeographyWellKnownValue
        - `coordinateSystemId` integer
        - `wellKnownText` string
        - `wellKnownBinary` string, byte
    - `startDate` string, date-time
    - `endDate` string, date-time
    - `startTime` string
    - `endTime` string
  - `recurringSchedules` TflApiPresentationEntitiesRoadDisruptionSchedule[]
    - `startTime` string, date-time
    - `endTime` string, date-time

---

[API](https://skmtc.net/tfl/apis/transport-for-london-unified-api.md) · [All operations](https://skmtc.net/tfl/apis/transport-for-london-unified-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tfl/transport-for-london-unified-api/revisions/266abe0486b0/schema)