ws-dottie
Version:
Your friendly TypeScript companion for Washington State transportation APIs - WSDOT and WSF data with smart caching and React Query integration
1,063 lines (1,048 loc) • 49.6 kB
YAML
openapi: 3.0.0
info:
title: Wsdot Highway Alerts API
version: 1.0.0
description: Wsdot Highway Alerts API - Washington State Department of Transportation APIs
servers:
- url: https://www.wsdot.wa.gov/traffic/api/highwayalerts/highwayalertsrest.svc
description: Production server
components:
schemas:
RoadwayLocation:
type: object
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location information including route, milepost, coordinates, and direction.
FetchAlertByIdOutput:
type: object
properties:
AlertID:
type: integer
description: Numeric ID of the highway alert.
County:
type: string
nullable: true
description: County name for countywide alerts, or null when alert is route-specific.
EndRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert ends, or null when alert is point-specific or end location is unavailable.
EndTime:
type: string
nullable: true
description: UTC datetime when the alert impact is estimated to end, or null when end time is not estimated or alert is ongoing.
format: date-time
EventCategory:
type: string
nullable: true
description: Category classification for the alert event type, or null when category is unavailable.
EventStatus:
type: string
nullable: true
description: 'Code indicating alert status: ''Open'' = active, ''Closed'' = resolved, or null when status is unavailable.'
ExtendedDescription:
type: string
nullable: true
description: Additional detailed information about the alert, or null when extended description is unavailable.
HeadlineDescription:
type: string
nullable: true
description: Primary description of the alert issue, or null when headline is unavailable.
LastUpdatedTime:
type: string
nullable: true
description: UTC datetime when the alert was last modified or updated.
format: date-time
Priority:
type: string
nullable: true
description: 'Code indicating traffic impact priority: ''Highest'' = severe, ''High'' = significant, ''Medium'' = moderate, ''Low'' = minimal, or null when priority is unavailable.'
Region:
type: string
nullable: true
description: 'Code indicating WSDOT region: ''EA'' = Eastern, ''NC'' = North Central, ''NW'' = Northwest, ''OL'' = Olympic, ''SC'' = South Central, ''SW'' = Southwest, or null when region is unavailable.'
StartRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert begins, or null when alert is point-specific or start location is unavailable.
StartTime:
type: string
nullable: true
description: UTC datetime when the alert impact on traffic began.
format: date-time
required:
- AlertID
- County
- EndRoadwayLocation
- EndTime
- EventCategory
- EventStatus
- ExtendedDescription
- HeadlineDescription
- LastUpdatedTime
- Priority
- Region
- StartRoadwayLocation
- StartTime
description: Highway alert with identification, event category, priority, location data, timestamps, and descriptions for traffic incidents and road conditions.
parameters: {}
paths:
/getAlertsAsJson:
get:
summary: List all current highway alerts statewide.
operationId: fetchAlerts
tags:
- highwayAlerts
x-codeSamples:
- lang: JavaScript
source: |-
import { fetchAlerts } from 'ws-dottie/wsdot-highway-alerts/core';
const data = await fetchAlerts({
fetchMode: 'native',
validate: true
});
console.log(data);
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
AlertID:
type: integer
description: Numeric ID of the highway alert.
County:
type: string
nullable: true
description: County name for countywide alerts, or null when alert is route-specific.
EndRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert ends, or null when alert is point-specific or end location is unavailable.
EndTime:
type: string
nullable: true
description: UTC datetime when the alert impact is estimated to end, or null when end time is not estimated or alert is ongoing.
format: date-time
EventCategory:
type: string
nullable: true
description: Category classification for the alert event type, or null when category is unavailable.
EventStatus:
type: string
nullable: true
description: 'Code indicating alert status: ''Open'' = active, ''Closed'' = resolved, or null when status is unavailable.'
ExtendedDescription:
type: string
nullable: true
description: Additional detailed information about the alert, or null when extended description is unavailable.
HeadlineDescription:
type: string
nullable: true
description: Primary description of the alert issue, or null when headline is unavailable.
LastUpdatedTime:
type: string
nullable: true
description: UTC datetime when the alert was last modified or updated.
format: date-time
Priority:
type: string
nullable: true
description: 'Code indicating traffic impact priority: ''Highest'' = severe, ''High'' = significant, ''Medium'' = moderate, ''Low'' = minimal, or null when priority is unavailable.'
Region:
type: string
nullable: true
description: 'Code indicating WSDOT region: ''EA'' = Eastern, ''NC'' = North Central, ''NW'' = Northwest, ''OL'' = Olympic, ''SC'' = South Central, ''SW'' = Southwest, or null when region is unavailable.'
StartRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert begins, or null when alert is point-specific or start location is unavailable.
StartTime:
type: string
nullable: true
description: UTC datetime when the alert impact on traffic began.
format: date-time
required:
- AlertID
- County
- EndRoadwayLocation
- EndTime
- EventCategory
- EventStatus
- ExtendedDescription
- HeadlineDescription
- LastUpdatedTime
- Priority
- Region
- StartRoadwayLocation
- StartTime
description: Highway alert with identification, event category, priority, location data, timestamps, and descriptions for traffic incidents and road conditions.
examples:
sampleResponse:
summary: Sample response
description: Example of a successful response from the API (showing first item of 118 total)
value:
- AlertID: 670961
County: null
EndRoadwayLocation:
Description: null
Direction: 'N'
Latitude: 48.703758665
Longitude: -122.474705077
MilePost: 250
RoadName: '005'
EndTime: '2025-11-21T00:00:00.000Z'
EventCategory: Maintenance
EventStatus: Open
ExtendedDescription: ''
HeadlineDescription: Daily from 8 a.m. to 4 p.m. on Wednesday, Nov. 19 and Thursday, Nov. 20, maintenance crews will close one right lane of northbound Interstate 5 from North Lake Samish Overpass (milepost 246) to State Route 11/Chuckanut Drive (milepost 250) for rock removal.
LastUpdatedTime: '2025-11-13T20:14:26.087Z'
Priority: Medium
Region: Northwest
StartRoadwayLocation:
Description: null
Direction: 'N'
Latitude: 48.690337506
Longitude: -122.41057518
MilePost: 246.8
RoadName: '005'
StartTime: '2025-11-13T20:08:00.000Z'
/searchAlertsAsJson?StateRoute={StateRoute}&Region={Region}&SearchTimeStart={SearchTimeStart}&SearchTimeEnd={SearchTimeEnd}&StartingMilepost={StartingMilepost}&EndingMilepost={EndingMilepost}:
get:
summary: Search highway alerts by route, region, time range, and milepost.
operationId: searchAlerts
tags:
- highwayAlerts
x-codeSamples:
- lang: JavaScript
source: |-
import { searchAlerts } from 'ws-dottie/wsdot-highway-alerts/core';
const data = await searchAlerts({
params: {
"StateRoute": "405",
"StartingMilepost": 10,
"EndingMilepost": 20,
"SearchTimeStart": "2025-11-21",
"SearchTimeEnd": "2025-11-22"
},
fetchMode: 'native',
validate: true
});
console.log(data);
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
AlertID:
type: integer
description: Numeric ID of the highway alert.
County:
type: string
nullable: true
description: County name for countywide alerts, or null when alert is route-specific.
EndRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert ends, or null when alert is point-specific or end location is unavailable.
EndTime:
type: string
nullable: true
description: UTC datetime when the alert impact is estimated to end, or null when end time is not estimated or alert is ongoing.
format: date-time
EventCategory:
type: string
nullable: true
description: Category classification for the alert event type, or null when category is unavailable.
EventStatus:
type: string
nullable: true
description: 'Code indicating alert status: ''Open'' = active, ''Closed'' = resolved, or null when status is unavailable.'
ExtendedDescription:
type: string
nullable: true
description: Additional detailed information about the alert, or null when extended description is unavailable.
HeadlineDescription:
type: string
nullable: true
description: Primary description of the alert issue, or null when headline is unavailable.
LastUpdatedTime:
type: string
nullable: true
description: UTC datetime when the alert was last modified or updated.
format: date-time
Priority:
type: string
nullable: true
description: 'Code indicating traffic impact priority: ''Highest'' = severe, ''High'' = significant, ''Medium'' = moderate, ''Low'' = minimal, or null when priority is unavailable.'
Region:
type: string
nullable: true
description: 'Code indicating WSDOT region: ''EA'' = Eastern, ''NC'' = North Central, ''NW'' = Northwest, ''OL'' = Olympic, ''SC'' = South Central, ''SW'' = Southwest, or null when region is unavailable.'
StartRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert begins, or null when alert is point-specific or start location is unavailable.
StartTime:
type: string
nullable: true
description: UTC datetime when the alert impact on traffic began.
format: date-time
required:
- AlertID
- County
- EndRoadwayLocation
- EndTime
- EventCategory
- EventStatus
- ExtendedDescription
- HeadlineDescription
- LastUpdatedTime
- Priority
- Region
- StartRoadwayLocation
- StartTime
description: Highway alert with identification, event category, priority, location data, timestamps, and descriptions for traffic incidents and road conditions.
examples:
sampleResponse:
summary: Sample response
description: Example of a successful response from the API (showing first item of 14 total)
value:
- AlertID: 671050
County: null
EndRoadwayLocation:
Description: null
Direction: S
Latitude: 0
Longitude: 0
MilePost: 0
RoadName: '405'
EndTime: '2025-11-14T15:22:31.000Z'
EventCategory: Disabled vehicle
EventStatus: Closed
ExtendedDescription: ''
HeadlineDescription: 'Cleared 7:22 AM : On I-405 southbound at NE 70th Pl (MP 17) there is a disabled vehicle blocking the right lane. The State Patrol has arrived on the scene.'
LastUpdatedTime: '2025-11-14T15:22:31.560Z'
Priority: Highest
Region: Northwest
StartRoadwayLocation:
Description: null
Direction: S
Latitude: 47.670427237
Longitude: -122.187174248
MilePost: 17.49
RoadName: '405'
StartTime: '2025-11-14T14:54:00.000Z'
/getAlertsByRegionIDAsJson?RegionID={RegionID}:
get:
summary: List highway alerts filtered by WSDOT region ID.
operationId: fetchAlertsByRegionId
tags:
- highwayAlerts
x-codeSamples:
- lang: JavaScript
source: |-
import { fetchAlertsByRegionId } from 'ws-dottie/wsdot-highway-alerts/core';
const data = await fetchAlertsByRegionId({
params: {
"RegionID": 4
},
fetchMode: 'native',
validate: true
});
console.log(data);
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
AlertID:
type: integer
description: Numeric ID of the highway alert.
County:
type: string
nullable: true
description: County name for countywide alerts, or null when alert is route-specific.
EndRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert ends, or null when alert is point-specific or end location is unavailable.
EndTime:
type: string
nullable: true
description: UTC datetime when the alert impact is estimated to end, or null when end time is not estimated or alert is ongoing.
format: date-time
EventCategory:
type: string
nullable: true
description: Category classification for the alert event type, or null when category is unavailable.
EventStatus:
type: string
nullable: true
description: 'Code indicating alert status: ''Open'' = active, ''Closed'' = resolved, or null when status is unavailable.'
ExtendedDescription:
type: string
nullable: true
description: Additional detailed information about the alert, or null when extended description is unavailable.
HeadlineDescription:
type: string
nullable: true
description: Primary description of the alert issue, or null when headline is unavailable.
LastUpdatedTime:
type: string
nullable: true
description: UTC datetime when the alert was last modified or updated.
format: date-time
Priority:
type: string
nullable: true
description: 'Code indicating traffic impact priority: ''Highest'' = severe, ''High'' = significant, ''Medium'' = moderate, ''Low'' = minimal, or null when priority is unavailable.'
Region:
type: string
nullable: true
description: 'Code indicating WSDOT region: ''EA'' = Eastern, ''NC'' = North Central, ''NW'' = Northwest, ''OL'' = Olympic, ''SC'' = South Central, ''SW'' = Southwest, or null when region is unavailable.'
StartRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert begins, or null when alert is point-specific or start location is unavailable.
StartTime:
type: string
nullable: true
description: UTC datetime when the alert impact on traffic began.
format: date-time
required:
- AlertID
- County
- EndRoadwayLocation
- EndTime
- EventCategory
- EventStatus
- ExtendedDescription
- HeadlineDescription
- LastUpdatedTime
- Priority
- Region
- StartRoadwayLocation
- StartTime
description: Highway alert with identification, event category, priority, location data, timestamps, and descriptions for traffic incidents and road conditions.
examples:
sampleResponse:
summary: Sample response
description: Example of a successful response from the API
value: []
/getAlertsByMapAreaAsJson?MapArea={MapArea}:
get:
summary: List highway alerts filtered by map area code.
operationId: fetchAlertsByMapArea
tags:
- highwayAlerts
x-codeSamples:
- lang: JavaScript
source: |-
import { fetchAlertsByMapArea } from 'ws-dottie/wsdot-highway-alerts/core';
const data = await fetchAlertsByMapArea({
params: {
"MapArea": "Seattle"
},
fetchMode: 'native',
validate: true
});
console.log(data);
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
AlertID:
type: integer
description: Numeric ID of the highway alert.
County:
type: string
nullable: true
description: County name for countywide alerts, or null when alert is route-specific.
EndRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert ends, or null when alert is point-specific or end location is unavailable.
EndTime:
type: string
nullable: true
description: UTC datetime when the alert impact is estimated to end, or null when end time is not estimated or alert is ongoing.
format: date-time
EventCategory:
type: string
nullable: true
description: Category classification for the alert event type, or null when category is unavailable.
EventStatus:
type: string
nullable: true
description: 'Code indicating alert status: ''Open'' = active, ''Closed'' = resolved, or null when status is unavailable.'
ExtendedDescription:
type: string
nullable: true
description: Additional detailed information about the alert, or null when extended description is unavailable.
HeadlineDescription:
type: string
nullable: true
description: Primary description of the alert issue, or null when headline is unavailable.
LastUpdatedTime:
type: string
nullable: true
description: UTC datetime when the alert was last modified or updated.
format: date-time
Priority:
type: string
nullable: true
description: 'Code indicating traffic impact priority: ''Highest'' = severe, ''High'' = significant, ''Medium'' = moderate, ''Low'' = minimal, or null when priority is unavailable.'
Region:
type: string
nullable: true
description: 'Code indicating WSDOT region: ''EA'' = Eastern, ''NC'' = North Central, ''NW'' = Northwest, ''OL'' = Olympic, ''SC'' = South Central, ''SW'' = Southwest, or null when region is unavailable.'
StartRoadwayLocation:
type: object
nullable: true
properties:
Description:
type: string
nullable: true
description: Human-readable description of the roadway location, such as interchange names or cross streets.
Direction:
type: string
nullable: true
description: 'Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected.'
Latitude:
type: number
description: Latitude of the roadway location in decimal degrees.
Longitude:
type: number
description: Longitude of the roadway location in decimal degrees.
MilePost:
type: number
description: Milepost marker along the highway corridor, with 0 indicating route terminus.
RoadName:
type: string
nullable: true
description: Highway or route designation code, such as '005' for I-5 or '090' for I-90.
required:
- Description
- Direction
- Latitude
- Longitude
- MilePost
- RoadName
description: Roadway location where the alert begins, or null when alert is point-specific or start location is unavailable.
StartTime:
type: string
nullable: true
description: UTC datetime when the alert impact on traffic began.
format: date-time
required:
- AlertID
- County
- EndRoadwayLocation
- EndTime
- EventCategory
- EventStatus
- ExtendedDescription
- HeadlineDescription
- LastUpdatedTime
- Priority
- Region
- StartRoadwayLocation
- StartTime
description: Highway alert with identification, event category, priority, location data, timestamps, and descriptions for traffic incidents and road conditions.
examples:
sampleResponse:
summary: Sample response
description: Example of a successful response from the API
value:
- AlertID: 473325
County: null
EndRoadwayLocation:
Description: null
Direction: B
Latitude: 0
Longitude: 0
MilePost: 0
RoadName: '005'
EndTime: null
EventCategory: Rest Area
EventStatus: Open
ExtendedDescription: ''
HeadlineDescription: Until further notice - The Interstate 5 Silver Lake Rest Area is closed for maintenance indefinitely. There is no access for recreational vehicle dumping at this location.
LastUpdatedTime: '2023-07-24T22:25:55.483Z'
Priority: High
Region: Northwest
StartRoadwayLocation:
Description: SB Scale 39/Silver Lake Rest Area
Direction: B
Latitude: 47.907026048
Longitude: -122.210954765
MilePost: 188.5
RoadName: '005'
StartTime: '2021-09-24T13:00:00.000Z'
/getAlertAsJson?AlertID={AlertID}:
get:
summary: Get highway alert details for a specific alert ID.
operationId: fetchAlertById
tags:
- highwayAlerts
x-codeSamples:
- lang: JavaScript
source: |-
import { fetchAlertById } from 'ws-dottie/wsdot-highway-alerts/core';
const data = await fetchAlertById({
params: {
"AlertID": 468632
},
fetchMode: 'native',
validate: true
});
console.log(data);
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/FetchAlertByIdOutput'
examples:
sampleResponse:
summary: Sample response
description: Example of a successful response from the API
value:
AlertID: 468632
County: null
EndRoadwayLocation:
Description: null
Direction: B
Latitude: 47.6390387
Longitude: -122.220590099
MilePost: 5
RoadName: '520'
EndTime: null
EventCategory: Flammable Cargo Restriction
EventStatus: Closed
ExtendedDescription: ''
HeadlineDescription: Flammable cargo is prohibited on SR 520 eastbound & westbound from Montlake Blvd (MP 1) to 84th Ave NE (MP 5).
LastUpdatedTime: '2025-09-03T04:40:03.430Z'
Priority: High
Region: Northwest
StartRoadwayLocation:
Description: null
Direction: B
Latitude: 47.644373883
Longitude: -122.303082155
MilePost: 1
RoadName: '520'
StartTime: '2021-09-13T13:59:00.000Z'
/getMapAreasAsJson:
get:
summary: List all available geographic map areas for filtering alerts.
operationId: fetchMapAreas
tags:
- highwayAlerts
x-codeSamples:
- lang: JavaScript
source: |-
import { fetchMapAreas } from 'ws-dottie/wsdot-highway-alerts/core';
const data = await fetchMapAreas({
fetchMode: 'native',
validate: true
});
console.log(data);
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
MapArea:
type: string
nullable: true
description: Map area identifier code for geographic filtering, or null when unavailable.
MapAreaDescription:
type: string
nullable: true
description: Display name of the map area, or null when unavailable.
required:
- MapArea
- MapAreaDescription
description: Geographic map area with identifier code and display name for filtering highway alerts by region.
examples:
sampleResponse:
summary: Sample response
description: Example of a successful response from the API (showing first item of 51 total)
value:
- MapArea: L2CE
MapAreaDescription: Eastern
/getEventCategoriesAsJson:
get:
summary: List all available event category names for filtering alerts.
operationId: fetchEventCategories
tags:
- event-categories
x-codeSamples:
- lang: JavaScript
source: |-
import { fetchEventCategories } from 'ws-dottie/wsdot-highway-alerts/core';
const data = await fetchEventCategories({
fetchMode: 'native',
validate: true
});
console.log(data);
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: string
examples:
sampleResponse:
summary: Sample response
description: Example of a successful response from the API (showing first item of 123 total)
value:
- ''
tags:
- name: highwayAlerts
description: Real-time highway alerts for traffic incidents and road conditions.
x-description: Traffic incidents, construction, maintenance, and other events affecting Washington State highways, including location details, impact levels, timestamps, and event classifications.
x-cacheStrategy: FREQUENT
x-useCases:
- Monitor real-time traffic incidents and road conditions.
- Plan alternate routes based on current highway alerts.
- Display active alerts filtered by location, region, or category.
- Track alert status and estimated resolution times.
x-updateFrequency: 5m
- name: alertAreas
description: Geographic map areas for filtering highway alerts by region.
x-description: Area codes and names used to organize and filter highway alerts across Washington State geographic regions.
x-cacheStrategy: FREQUENT
x-useCases:
- Filter highway alerts by geographic map area.
- Obtain valid area codes for alert queries.
- Display regional alert organization in user interfaces.
x-updateFrequency: 5m
- name: event-categories
description: Event category classifications for highway alerts.
x-description: Standardized category names used to classify and filter highway alerts by incident type, such as construction, collisions, maintenance, and weather events.
x-cacheStrategy: FREQUENT
x-useCases:
- Filter highway alerts by event category type.
- Obtain valid category names for alert searches.
- Categorize alerts in user interfaces by incident type.
x-updateFrequency: 5m