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.com for development purposes only.
  • Use hostname api.accuweather.com for 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 CodeResponse NameDescription
200 OK The request was fulfilled.
Error Response CodeResponse NameDescription
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.