/alerts?lat={lat}&lon={lon}

Returns severe weather alerts issued by meteorological agencies - Given a lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• callback (query) — Wraps return in jsonp callback - Example - callback=func
• key (query, required) — Your registered API key.

/bulk/files/{file}

Download pre-generated bulk datasets

• file (path, required) — Filename (ie. current.csv.gz)
• key (query, required) — Your registered API key.

/current/airquality?city={city}&country={country}

Returns current air quality conditions - Given City and/or State, Country.

• city (path, required) — City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
• state (query) — Full name of state.
• country (path, required) — Country Code (2 letter).
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/current/airquality?city_id={city_id}

Returns current air quality conditions - Given a City ID.

• city_id (path, required) — City ID. Example: 4487042
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• key (query, required) — Your registered API key.

/current/airquality?lat={lat}&lon={lon}

Returns current air quality conditions - Given a lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• key (query, required) — Your registered API key.

/current/airquality?postal_code={postal_code}

Returns current air quality conditions - Given a Postal Code.

• postal_code (path, required) — Postal Code. Example: 28546
• country (query) — Country Code (2 letter).
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• key (query, required) — Your registered API key.

/current?cities={cities}

Returns a group of observations given a list of cities

• cities (path, required) — Comma separated list of City ID's. Example: 4487042, 4494942, 4504871
• units (query) — Convert to units. Default Metric See units field description
• marine (query) — Marine stations only (buoys, oil platforms, etc)
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback - Example - callback=func
• key (query, required) — Your registered API key.

/current?city={city}&country={country}

Returns a Current Observation - Given City and/or State, Country.

• city (path, required) — City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
• include (query) — Include 1 hour - minutely forecast in the response
• state (query) — Full name of state.
• country (path, required) — Country Code (2 letter).
• marine (query) — Marine stations only (buoys, oil platforms, etc)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback - Example - callback=func
• key (query, required) — Your registered API key.

/current?city_id={city_id}

Returns a current observation by city id.

• city_id (path, required) — City ID. Example: 4487042
• units (query) — Convert to units. Default Metric See units field description
• include (query) — Include 1 hour - minutely forecast in the response
• marine (query) — Marine stations only (buoys, oil platforms, etc)
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback - Example - callback=func
• key (query, required) — Your registered API key.

/current?lat={lat}&lon={lon}

Returns a Current Observation - Given a lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• include (query) — Include 1 hour - minutely forecast in the response
• marine (query) — Marine stations only (buoys, oil platforms, etc)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback - Example - callback=func
• key (query, required) — Your registered API key.

/current?points={points}

Returns a group of observations given a list of points in the format (lat1, lon1), (lat2, lon2), (latN, lonN), ...

• points (path, required) — Comma separated list of points. Example: (35.5, -75.5),(45, 65),(45.12, -130.5)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/current?postal_code={postal_code}

Returns a current observation by postal code.

• postal_code (path, required) — Postal Code. Example: 28546
• country (query) — Country Code (2 letter).
• include (query) — Include 1 hour - minutely forecast in the response
• marine (query) — Marine stations only (buoys, oil platforms, etc)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback - Example - callback=func
• key (query, required) — Your registered API key.

/current?station={station}

Returns a Current Observation. - Given a station ID.

• station (path, required) — Station Call ID.
• include (query) — Include 1 hour - minutely forecast in the response
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/current?stations={stations}

Returns a group of observations given a list of stations

• stations (path, required) — Comma separated list of Station Call ID's. Example: KRDU,KBFI,KVNY
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/forecast/airquality?city={city}&country={country}

Returns 72 hour (hourly) Air Quality forecast - Given City and/or State, Country.

• city (path, required) — City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
• state (query) — Full name of state.
• country (path, required) — Country Code (2 letter).
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• hours (query) — Number of hours to return.
• key (query, required) — Your registered API key.

/forecast/airquality?city_id={city_id}

Returns 72 hour (hourly) Air Quality forecast - Given a City ID.

• city_id (path, required) — City ID. Example: 4487042
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• hours (query) — Number of hours to return.
• key (query, required) — Your registered API key.

/forecast/airquality?lat={lat}&lon={lon}

Returns 72 hour (hourly) Air Quality forecast - Given a lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• key (query, required) — Your registered API key.
• hours (query) — Number of hours to return.

/forecast/airquality?postal_code={postal_code}

Returns 72 hour (hourly) Air Quality forecast - Given a Postal Code.

• postal_code (path, required) — Postal Code. Example: 28546
• country (query) — Country Code (2 letter).
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• hours (query) — Number of hours to return.
• key (query, required) — Your registered API key.

/forecast/daily?city={city}&country={country}

Returns a daily forecast - Given City and/or State, Country.

• city (path, required) — City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
• state (query) — Full name of state.
• country (path, required) — Country Code (2 letter).
• days (query) — Number of days to return. Default 16.
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• key (query, required) — Your registered API key.

/forecast/daily?city_id={city_id}

Returns a daily forecast - Given a City ID.

• city_id (path, required) — City ID. Example: 4487042
• days (query) — Number of days to return. Default 16.
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/forecast/daily?lat={lat}&lon={lon}

Returns a daily forecast - Given Lat/Lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• days (query) — Number of days to return. Default 16.
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/forecast/daily?postal_code={postal_code}

Returns a daily forecast - Given a Postal Code.

• postal_code (path, required) — Postal Code. Example: 28546
• country (query) — Country Code (2 letter).
• days (query) — Number of days to return. Default 16.
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/forecast/energy?lat={lat}&lon={lon}

Returns Energy Forecast API response - Given a single lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• threshold (query) — Temperature threshold to use to calculate degree days (default 18 C)
• units (query) — Convert to units. Default Metric See units field description
• tp (query) — Time period (default: daily)
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/forecast/hourly?city={city}&country={country}

Returns an hourly forecast - Given City and/or State, Country.

• city (path, required) — City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
• state (query) — Full name of state.
• country (path, required) — Country Code (2 letter).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• hours (query) — Number of hours to return.
• key (query, required) — Your registered API key.

/forecast/hourly?city_id={city_id}

Returns an hourly forecast - Given a City ID.

• city_id (path, required) — City ID. Example: 4487042
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• hours (query) — Number of hours to return.
• key (query, required) — Your registered API key.

/forecast/hourly?lat={lat}&lon={lon}

Returns an hourly forecast - Given a lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• key (query, required) — Your registered API key.
• hours (query) — Number of hours to return.

/forecast/hourly?postal_code={postal_code}

Returns an hourly forecast - Given a Postal Code.

• postal_code (path, required) — Postal Code. Example: 28546
• country (query) — Country Code (2 letter).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• hours (query) — Number of hours to return.
• key (query, required) — Your registered API key.

/history/airquality?city={city}&country={country}

Returns 72 hours of historical quality conditions - Given City and/or State, Country.

• city (path, required) — City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
• state (query) — Full name of state.
• country (path, required) — Country Code (2 letter).
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/airquality?city_id={city_id}

Returns 72 hours of historical air quality conditions - Given a City ID.

• city_id (path, required) — City ID.
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• key (query, required) — Your registered API key.

/history/airquality?lat={lat}&lon={lon}

Returns 72 hours of historical air quality conditions - Given a lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• key (query, required) — Your registered API key.

/history/airquality?postal_code={postal_code}

Returns 72 hours of historical air quality conditions - Given a Postal Code.

• postal_code (path, required) — Postal Code. Example: 28546
• country (query) — Country Code (2 letter).
• callback (query) — Wraps return in jsonp callback. Example - callback=func
• key (query, required) — Your registered API key.

/history/daily?city={city}&country={country}

Returns Historical Observations - Given City and/or State, Country.

• city (path, required) — City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
• state (query) — Full name of state.
• country (path, required) — Country Code (2 letter).
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/daily?city_id={city_id}

Returns Historical Observations - Given a City ID

• city_id (path, required) — City ID. Example: 4487042
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/daily?lat={lat}&lon={lon}

Returns Historical Observations - Given a lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/daily?postal_code={postal_code}

Returns Historical Observations - Given a Postal Code

• postal_code (path, required) — Postal Code. Example: 28546
• country (query) — Country Code (2 letter).
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/daily?station={station}

Returns Historical Observations - Given a station ID.

• station (path, required) — Station ID.
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/energy?lat={lat}&lon={lon}

Returns Energy API response - Given a single lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• tp (query) — Time period to aggregate by (daily, monthly)
• threshold (query) — Temperature threshold to use to calculate degree days (default 18 C)
• units (query) — Convert to units. Default Metric See units field description
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/hourly?city={city}&country={country}

Returns Historical Observations - Given City and/or State, Country.

• city (path, required) — City search. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
• state (query) — Full name of state.
• country (path, required) — Country Code (2 letter).
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/hourly?city_id={city_id}

Returns Historical Observations - Given a City ID

• city_id (path, required) — City ID. Example: 4487042
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/hourly?lat={lat}&lon={lon}

Returns Historical Observations - Given a lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/hourly?postal_code={postal_code}

Returns Historical Observations - Given a Postal Code

• postal_code (path, required) — Postal Code. Example: 28546
• country (query) — Country Code (2 letter).
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/hourly?station={station}

Returns Historical Observations - Given a station ID.

• station (path, required) — Station ID.
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/subhourly?city={city}&country={country}

Returns Historical Observations - Given City and/or State, Country.

• city (path, required) — City search. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
• state (query) — Full name of state.
• country (path, required) — Country Code (2 letter).
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/subhourly?city_id={city_id}

Returns Historical Observations - Given a City ID

• city_id (path, required) — City ID. Example: 4487042
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/subhourly?lat={lat}&lon={lon}

Returns Historical Observations - Given a lat/lon.

• lat (path, required) — Latitude component of location.
• lon (path, required) — Longitude component of location.
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/subhourly?postal_code={postal_code}

Returns Historical Observations - Given a Postal Code

• postal_code (path, required) — Postal Code. Example: 28546
• country (query) — Country Code (2 letter).
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH)
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.

/history/subhourly?station={station}

Returns Historical Observations - Given a station ID.

• station (path, required) — Station ID.
• start_date (query, required) — Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• end_date (query, required) — End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
• units (query) — Convert to units. Default Metric See units field description
• lang (query) — Language (Default: English) See language field description
• tz (query) — Assume utc (default) or local time for start_date, end_date
• callback (query) — Wraps return in jsonp callback. Example: callback=func
• key (query, required) — Your registered API key.