Raindrop collects surface observations from weather station networks across Canada and the United States, along with ECCC weather alerts. It serves them over a JSON REST API.
https://raindrop.cssl.ca/api/v1
The OpenAPI document is at /openapi/v1.json, and there’s an interactive explorer at /swagger.
Endpoints
| Endpoint | Description | Access |
|---|---|---|
GET /stations/map/markers |
Location of every station, as GeoJSON | Public |
GET /stations/map/details |
Metadata for every station | Public |
GET /stations/{stationId} |
Metadata for one station | Public |
GET /stations/readings |
Readings for stations in an area | Public |
POST /stations/readings |
Readings for specific stations | Public |
POST /observations/series |
One variable at one station over time | Public |
GET /observations/units |
The unit of each variable | Public |
GET /alerts |
ECCC weather alerts, as GeoJSON | Public |
GET /alerts/zones |
Forecast zone boundaries | Public |
POST /historical/bulk |
Paginated CSV export | Commercial |
GET /capabilities |
What your credential can access | Public |
GET /message-of-the-day |
The current Weather Intelligence announcement | Public |
Raindrop no longer serves raster files. For hail size, lightning and reflectivity grids, use Cyclone’s MRMS sources.
Conventions
- Times are UTC, in ISO 8601. Always send a
Zor an explicit offset. - Field names are camelCase. Fields with no value are left out of the response, not returned as
null. - Enums are strings, such as
"Instantaneous"or"Good". - Station IDs are UUIDs. They stay the same between requests.
- GeoJSON coordinates are
[longitude, latitude]. So is thecoordinatesfield on station details. - Values are converted to a standard unit per variable when they’re ingested: °C, km/h, hPa and so on. Look them up with
/observations/unitsrather than assuming. - Responses are compressed with gzip or Brotli if you send
Accept-Encoding.curl --compresseddoes this. It matters: the full station list is about 15 MB uncompressed and under 1 MB compressed.
Time windows
/stations/readings and /observations/series limit how much history you can request. The limit depends on your plan:
| Plan | Lookback |
|---|---|
| No account, Free | 7 days |
| Pro | 30 days |
| Commercial, or any API key | Unlimited |
The lookback applies twice:
end - startcan’t be longer than the lookback.endcan’t be further back than the lookback (plus a one-hour grace period).
Without an account, then, you can request any window of up to 7 days that ends within the last 7 days. Requests that break either rule get a 400 whose message states the limit.
Other endpoints have their own rules. /alerts windows can span at most 31 days on every plan, with no limit on how far back they reach. Bulk export has no window limit. No endpoint accepts timestamps before 1800-01-01.
Rate limits
Each IP address can make 150 requests per 10 seconds across the whole API, except bulk export, which has its own allowance of 500 requests per 10 seconds. A short burst over the limit is queued rather than refused. Past that, the API returns 429 Too Many Requests with an empty body and no Retry-After header, so back off and retry.
Browser access (CORS)
Browsers can only call the API from *.cssl.ca sites. If you’re building a web app on another domain, make the requests from your server.
Errors
| Status | Body |
|---|---|
400 |
A JSON string describing the problem, such as "start must be before end.", or empty when a required parameter is missing or can’t be parsed |
401, 403 |
Empty, or {"reason": "…"} for a rejected token. See Authentication. |
404 |
Empty or a JSON string, depending on the endpoint |
429 |
Empty |
500 |
Empty, or an RFC 7807 application/problem+json object |
Most error bodies are a bare JSON string, not an object. Parse the body as JSON and check its type before reading fields from it.
Message of the day
Returns the announcement Weather Intelligence shows its visitors. You don’t need an account. When there’s no current message, the response is 204 with no body. Responses are sent with Cache-Control: no-store, so a new message shows up on the next request.
{
"id": "01a1b1a2-7d8e-7ae6-9094-433b6f177eca",
"title": "Small Update! (v2026.11.06)",
"body": "This update to CSSL Weather Intelligence integrates an open-source version of the NAM model, adds customizable units, …",
"publishedAt": "2026-11-06T16:12:58.638284Z"
}
idstringChanges with every new message. Store it to remember that a visitor has dismissed this one.
titlestringUp to 200 characters.
bodystringMarkdown, up to 20,000 characters. Trimmed in the example above.
emojistringOptional. A short emoji string that Weather Intelligence animates when the message opens. Left out when there isn’t one.
publishedAtdatetimeWhen the message was published.