Environment

Historical weather from 1940 (hourly and daily, worldwide)

Sugra Weather history for any coordinate or city worldwide, from 1940-01-01 to the recent past: daily aggregates (temperature and feels-like min/max/mean, sunrise/sunset, daylight and sunshine duration, precipitation sums and hours, wind maxima and dominant direction, solar radiation, reference evapotranspiration, WMO weather code) plus full hourly steps for ranges up to a year. Reanalysis-backed for every location on Earth. Units, timezone, and time format are configurable; resolve any city by name with the optional country filter. Ranges up to 10 years per request.

get/api/v2/weather/history

Query parameters

start_datestring required

Range start, YYYY-MM-DD (1940-01-01 or later).

Example:1943-02-01

Range start, YYYY-MM-DD (1940-01-01 or later).

end_datestring required

Range end, YYYY-MM-DD (inclusive).

Example:1943-02-07

Range end, YYYY-MM-DD (inclusive).

latitudenumber nullable

Latitude (-90 to 90).

Example:48.85

Latitude (-90 to 90).

longitudenumber nullable

Longitude (-180 to 180).

Example:2.35

Longitude (-180 to 180).

latnumber nullable

Latitude alias (same as latitude).

Example:48.85

Latitude alias (same as latitude).

lonnumber nullable

Longitude alias (same as longitude).

Example:2.35

Longitude alias (same as longitude).

citystring nullable

City name (alternative to lat/lon), resolved globally.

Example:Paris

City name (alternative to lat/lon), resolved globally.

countrystring nullable

Country name or ISO-2 code (narrows the city match).

Example:FR

Country name or ISO-2 code (narrows the city match).

temperature_unitstring

Temperature unit: celsius | fahrenheit.

Example:celsius

Temperature unit: celsius | fahrenheit.

wind_speed_unitstring

Wind speed unit: kmh | ms | mph | kn.

Example:ms

Wind speed unit: kmh | ms | mph | kn.

precipitation_unitstring

Precipitation unit: mm | inch.

Example:mm

Precipitation unit: mm | inch.

timezonestring

IANA timezone for timestamps, or 'auto'.

Example:auto

IANA timezone for timestamps, or 'auto'.

timeformatstring

Timestamp format: iso8601 | unixtime.

Example:iso8601

Timestamp format: iso8601 | unixtime.

languagestring

Locale for the human condition text (13 supported).

Example:en

Locale for the human condition text (13 supported).

Response

Daily (and hourly for ranges up to a year) archive with units and provenance.

Example response

{
  "data": {
    "resolved_location": {
      "name": "Jakarta",
      "country": "Indonesia",
      "country_code": "ID",
      "admin1": "Jakarta",
      "timezone": "Asia/Jakarta"
    },
    "hourly": [
      {
        "condition_icon": "cloud-snow"
      }
    ],
    "provenance": {
      "source": "openmeteo",
      "product": "Sugra Weather forecast",
      "models": "best_match",
      "licence": "CC-BY-4.0",
      "attribution": "Weather data by Open-Meteo.com"
    }
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

Changed in 3 of the 22 revisions of this API.16

Sep 1, 2026328d061c12ca3See the full diff
- ○
  added the optional property meta/data_age_days to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/notes to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/period to the response with the 200 status
  response-optional-property-added
Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added
Jul 26, 20267fc920a3005c1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history