v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB

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",
    "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"
    ]
  }
}