Menu
DTN logo Content Services

Weather API

Open API Specification

Open API Specification (Swagger) documentation can be found here: Weather REST API To test the APIs in the documentation site, click the Authorize button.  Paste the test key of oViXqthDGFNVw3IvAsnKrFG1AcfPyA6b in the apikey-query text box. You may need to right click and select Copy from the pop-up menu to copy the API key.

Observations and Forecasts

The Weather API can be used to build out your own Weather displays on your own web site.

The DTN Weather API supports daily and hourly observations and forecasts.

Note:  The level of your subscription and associated API key gives you access to different API endpoints. Some other limits may apply.  For example, the number of days forecast is limited to 5, 10 or 15 days depending on your subscription. The number of days of observations available is dependent on your subscription.

The observations and forecasts endpoints use the provided latitude, longitude values to find the nearest official weather station and the weather content associated for that station.  Access to additional stations, including your own stations can be configured by DTN.

If you feel you have purchased the correct level of subscription and still do not have access to expected endpoints, stations or time limits, please contact DTN Support.

Times

All the times provided in the API responses are in UTC.

Various API’s ask for a number of days in the query parameter.  This is either a number of days into the future for forecasts, or number of days in the past for observations.

Daily forecasts will include the forecast for the current day.

Hourly forecasts are managed at the days level.  For days=2 will return 48 records.  The first record will be a forecast for the top of the current hour.

Units

The API does not return unit of measure for each field.  Instead, you can provide a query parameter of units for each of the APIs.  You can select to have US or SI (International System of Units).  The Open API Specification documentation indicates the unit of measure it will return for the provided query parameter unit.  The default is us/b>.

Weather Codes

0 Missing 15 Rain-Snow Mix 30  Freezing Rain Showers
1 Fair 16 Blizzard  31  Drizzle Showers
2 Partly Cloudy 17 Blowing Snow 32 Freezing Drizzle Showers
3 Cloudy 18 Rain 33 Passing Snow Showers
4 Dust 19 Snow 34 Passing Flurries
5 Mostly Sunny 20 Thunderstorms 35 Passing Rain Showers
6 Fog 21 Sunny 36 Passing Rain-Snow Showers
7 Very Hot and Humid 22 Clear 37 Passing Thunder Showers
8 Haze 23 Rain Showers 38 Passing Sleet Showers
9 Very Cold 24 Sleet(ice pellets) 39 Passing Freezing Rain Showers
10 Snow Showers 25 Freezing Rain 40 Passing Drizzle Showers
11 Smoke 26 Freezing Drizzle 41 Passing Freezing Drizzle Showers
12 Drizzle 27 Rain-Snow Mix Showers
13 Flurries 28 Thunder Showers
14 Windy 29 Sleet Showers