weather

Fetch Weather

Fetch weather data for given coordinates and entry time.

Uses OpenWeather API. Requires OPEN_WEATHER_API_KEY_25 or OPEN_WEATHER_API_KEY_30 to be configured. Returns structured error if weather service is not configured.

post/api/v1/weather/fetch

Request

  • The document declares no server URL.
  • Auth: OAuth 2 (password, token URL /api/v1/auth/token)

Cookies

access_tokenstring nullable

Request body

latitudenumber required

Latitude coordinate

longitudenumber required

Longitude coordinate

entry_datetime_utcstring date-time nullable

Entry timestamp in UTC (ISO format). If provided, weather is fetched for this time.

entry_timezonestring nullable

IANA timezone for the entry timestamp (e.g., America/Los_Angeles).

Response

Successful Response

OR

Example response

{
  "provider": "openweather",
  "timestamp": "2025-12-05T10:30:00Z",
  "weather": {
    "condition": "Clear",
    "description": "clear sky",
    "feels_like_c": 17.2,
    "feels_like_f": 63,
    "humidity": 65,
    "icon": "01d",
    "observed_at_utc": "2025-12-05T10:30:00Z",
    "pressure": 1013,
    "temp_c": 18.5,
    "temp_f": 65.3,
    "visibility": 10000,
    "wind_speed": 3.5
  }
}

Changes

No recorded changes to this operation across all 9 revisions of this API.