AccuWeather Enterprise API Documentation
New!
Free, instant access to AccuWeather APIs for developers.
Register at developer.accuweather.com and get free, limited access to a sampling of AccuWeather API endpoints, including Locations, Current Conditions, and Daily and Hourly Forecasts.
Access to the AccuWeather APIs available through developer.accuweather.com is separate from access to our Enterprise APIs that are described on this page. Free demo keys obtained at developer.accuweather.com will not work on links shown on this documentation site (apidev.accuweather.com/developers/). Thank you for your interest as we continue to expand the role of our new developer site, and thank you for choosing AccuWeather APIs!
The AccuWeather Enterprise API provides subscribers access to location-based weather data via a simple RESTful web interface.
- Access to the AccuWeather Enterprise API requires an API key. Contact sales@accuweather.com to receive an API key.
- If required by the terms of your agreement, a partner code will be provided to you by your AccuWeather representative. Please append the assigned partner code to the links provided in the output. Click here for an example.
- Data is available in more than 200 languages and dialects.
- Use hostname
apidev.accuweather.comfor development purposes only. - Use hostname
api.accuweather.comfor production purposes only. - All data responses are returned in JSON. Historical API endpoints offer optional CSV formatting as well.
- Data encryption is also available for secure communication with your set up. This is done with the use of
https://scheme in your URLs. - JSONP is available. Please use "parse_response" as the callback parameter
- Quick Start Guides are available in select localized languages for easier developer implementation.
- If using our Legacy API to obtain weather data, please click here for documentation.
- Stay informed on service availability for AccuWeather products and services 24/7/365 with status.accuweather.com.
Response Codes
All requests will return an appropriate response code. It is possible to suppress error codes by passing allowError=false in the query. In that case, the response will always be 200, barring a 500 error from the server itself. Error response describe the specifics of any errors.
| Success Response Code | Response Name | Description |
|---|---|---|
| 200 | OK | The request was fulfilled. |
| Error Response Code | Response Name | Description |
|---|---|---|
| 400 | Bad Request | The request had bad syntax or the parameters supplied were invalid. |
| 403 | Forbidden | A valid API Key was not supplied in the query. |
| 404 | Not Found | The server has not found a route matching the given URI. |
| 409 | Conflict | The allowed number of requests has been exceeded. |
| 500 | Internal Error | The server encountered an unexpected condition which prevented it from fulfilling the request. |
| 503 | Service Unavailable | The server is currently unavailable. |
Resources
Locations
Locations may be cities, points of interest, postal codes, countries, administrative areas (i.e. states and provinces) or regions.
Current Conditions
Current weather observations for a particular location. Most recent and historical current condition observations are available for given locations.
Alerts
Severe weather alerts for given locations.
Daily Indices
Daily indices for a particular location. Daily indices can be retrieved in 1, 5, 10, or 15 day intervals.
Weather Alarms
Weather alarms for a particular location. Weather alarms can be retrieved in 1, 5, 10, 15 or 25 day intervals.
Climo
Climatology data for a particular location. Climatology records, normals and actuals can be retrieved for a specific date or specific year/month for a given location.
Daily Forecasts
Daily forecasts for a particular location. Daily forecasts can be retrieved in 1, 5, 10, 15, 25, or 45 day intervals.
Hourly Forecasts
Hourly forecasts for a particular location. Hourly forecasts can be retrieved in 1, 12, 24, 72, 120, or 240 hour intervals.
Imagery
Imagery for a particular location. Radar and satellite images of varying resolutions (480x480, 317x237, 640x480, 640x640, 800x800, 1024x1024) are available for most locations.
Translations
List supported languages and translation groups. Provide translations for a particular group. Groups return a full set of translations for a specific language.
Quarter-day Forecasts
Forecasts divided into quarter-of-a-day increments. Quarter-day forecasts can be retrieved in 1, 5, 10, or 15 day intervals.
MinuteCast™
Minute-by-minute precipitation forecasts for the next 120 minutes from the present.
International Air Quality
Detailed information about contaminants currently in the air. Available for select locations only.
Tropical
Location-based information about tropical cyclones. Provides past, current, and forecasted positions of a cyclone.
Tidal Forecasts
Location-based ocean tide information. Tidal forecasts can be retrieved for 1, 5, 10, 15, 25, and 45 days.
Astronomy
Information regarding the sun and moon. Provides past, present, and future information with no date restrictions.
Deep Links
Direct links to to content in the AccuWeather website and mobile site. Deep links will return all available information with one call.
Maps
Provides a series of graphics in square tiles for layering on top of an existing map to illustrate weather conditions.
Historical
Weather data records as far back as January 1st, 2010. Search daily records with response formatting options and extended data.