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.

*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.

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