Environment

Historical weather from 1940 (hourly and daily, worldwide)

Changed on

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 plain city name, narrowed by the separate country parameter if given - an unresolvable location is 422, never 404. Ranges up to 10 years per request.

get/api/v2/weather/history

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v2/weather/history
  • Auth: API key in header x-api-key

Query parameters

start_datestring required

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

Example:1943-02-01
end_datestring required

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

Example:1943-02-07
latitudenumber nullable

Latitude (-90 to 90).

Example:48.85
longitudenumber nullable

Longitude (-180 to 180).

Example:2.35
latnumber nullable

Latitude alias (same as latitude).

Example:48.85
lonnumber nullable

Longitude alias (same as longitude).

Example:2.35
citystring nullable

Plain city name (alternative to lat/lon), resolved globally. The country goes in the separate country parameter, never combined into this field. An unresolvable location is 422, never 404.

Example:Paris
countrystring nullable

Country name or ISO-2 code (narrows the city match). Always a separate parameter from city.

Example:FR
temperature_unitstring

Temperature unit: celsius | fahrenheit.

Example:celsius
wind_speed_unitstring

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

Example:ms
precipitation_unitstring

Precipitation unit: mm | inch.

Example:mm
timezonestring

IANA timezone for timestamps, or 'auto'.

Example:auto
timeformatstring

Timestamp format: iso8601 | unixtime.

Example:iso8601
languagestring

Locale for the human condition text (13 supported).

Example:en

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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes