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.
*Hourly precipitation observed values are NOT available outside of the United States.
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 |