Raindrop ingests Environment and Climate Change Canada’s public alerts: watches, warnings, advisories and statements. They arrive in Common Alerting Protocol (CAP) format and are served as GeoJSON. Only the English text is kept.
Alerts
Returns a GeoJSON FeatureCollection of alerts. Each feature’s geometry is a MultiPolygon of the affected areas, and its properties describe the alert.
startdatetimequeryIf set, returns every stored revision whose validity overlaps start to end, except alerts ECCC retracted. If left out, returns only the current revision of each alert that’s active now.
The window can span at most 31 days, on every plan; page through longer periods a month at a time. History goes back to July 2012 and isn’t limited by plan. See Older alerts.
enddatetimequerydefault nowEnd of the window. Only used with start.
{
"type": "Feature",
"id": "urn:oid:2.49.0.1.124.3374137668.2026",
"geometry": { "type": "MultiPolygon", "coordinates": [] },
"properties": {
"id": "urn:oid:2.49.0.1.124.3374137668.2026",
"issuer": "Environment Canada",
"messageType": "Update",
"status": "Active",
"alertType": "Advisory",
"alertColour": "Yellow",
"alertImpact": "Moderate",
"alertConfidence": "High",
"alertHeadline": "FROST - IN EFFECT",
"event": "frost",
"effectiveTime": "2026-09-24T13:36:00Z",
"expiryTime": "2026-09-25T05:36:00Z",
"eventEndTime": "2026-09-25T14:00:00Z",
"sent": "2026-09-24T13:36:00Z",
"riskRanking": 8,
"coverage": "Gatineau",
"designationCode": "WZ_96_97_CWTO",
"previousIds": ["urn:oid:2.49.0.1.124.1371159753.2026"],
"areas": [
{ "description": "Gatineau", "kind": "Coverage", "threatStatus": "None", "clcCode": "031100", "polygons": [] }
]
}
}
alertTypestringStatement, Advisory, Watch or Warning.
alertColourstringECCC’s colour-coded severity: Yellow, Orange, Red or Unknown. Alerts issued before 2026, and some statements, are Unknown; fall back to alertType for those.
alertImpact, alertConfidencestringLow, Moderate, High, or Extreme (impact) or Very High (confidence). Either can also be Unknown.
messageTypestringAlert for a new alert, Update for a revision, or Cancel for the message that ends it.
statusstringActive, Superseded (replaced by a newer revision) or Ended. Alerts ECCC retracted aren’t returned.
previousIdsstring[]IDs of earlier revisions of this alert, oldest first. Use this to group revisions into one alert.
effectiveTime, expiryTimedatetimeWhen this revision is valid.
eventEndTimedatetimeWhen the weather itself is expected to end. It can be before or after expiryTime, and it’s left out when ECCC doesn’t give one.
riskRankingintegerECCC’s risk ranking. 1 is the highest risk.
areasobject[]The areas the alert covers. Each has a kind (Coverage for a forecast zone, ThreatArea for a storm polygon), a clcCode for forecast zones, and polygons as {lat, lon} rings. Use the feature geometry for drawing; it’s standard GeoJSON.
stormobjectStorm-based alerts only. The storm’s speedKmh, directionDegrees, centroid point, geometryType (IsolatedCell, Line or Area), observation time, and text descriptions of its position and motion.
Storm-based alerts
ECCC issues some severe thunderstorm and tornado warnings as polygons that follow the storm rather than covering whole forecast zones. A storm-based alert is updated every few minutes as the storm moves. Each update is a new revision with a longer previousIds chain. The alert ends with a final revision whose status is Ended.
When storms merge or split, ECCC ends the old alerts and starts new ones with an empty previousIds. The old and new alerts aren’t linked.
For these alerts, areas holds only the storm polygons (kind: "ThreatArea"), so the feature geometry is the storm itself.
Older alerts
Raindrop’s alert history goes back to July 2012, loaded from ECCC’s archive. Older alerts have less detail:
- Alerts issued before 2026 have
Unknowncolour, impact and confidence, and nodesignationCodeorriskRanking. - Alerts before 2017 have IDs without the
urn:oid:prefix, such as2.49.0.1.124.3b424566.2016. Treat IDs as opaque strings. - Alert zones are ECCC’s current boundaries, so zone codes from older alerts may no longer exist. Draw those areas from the alert’s own polygons.
Alert zones
The polygons embedded in CAP alerts are coarse and overlap one another. For a cleaner map, draw Coverage areas from ECCC’s forecast zone boundaries, looked up by each area’s clcCode.
codesstringqueryrequiredComma-separated zone codes, up to 200. Unknown codes are skipped; fall back to the alert’s own polygons for those.
Returns a GeoJSON FeatureCollection. Each feature’s id is the zone code, and its properties are clcCode, nameEn, nameFr, areaKm2 and centroid. Treat codes as opaque strings: air quality zones use compound codes like 082720-082732.
Zone boundaries rarely change, so cache them. Responses carry an ETag; send it back in If-None-Match to get a 304 when nothing has changed.