Weather during the stay

{
  "location": {
    "lat": 1.1,
    "lng": 1.1
  },
  "applicable": true,
  "sources": [
    {
      "provider": "string",
      "url": "string",
      "license": "string"
    }
  ],
  "meta": {
    "cached_at": "2024-01-15T09:30:00Z",
    "fresh_until": "2024-01-15T09:30:00Z",
    "partial": true,
    "request_id": "string"
  },
  "mode": "forecast",
  "date_range": {
    "start": "2023-01-15",
    "end": "2023-01-15"
  },
  "daily": [
    {
      "date": "2023-01-15",
      "temperature_2m_max": 1.1,
      "temperature_2m_min": 1.1,
      "precipitation_sum": 1.1,
      "precipitation_probability_max": 1.1,
      "wind_speed_10m_max": 1.1,
      "weather_code": 1
    }
  ]
}

Response shape is identical in either mode; the mode field tells the caller which is which so they can label the UI honestly (“This week’s forecast” vs “Typical mid-November”).

If the start date is within the 16-day forecast horizon, returns the actual forecast. Beyond that, returns climatology — averaged historical data for the same date range across the last 10 years, i.e. "usual weather for that time of year at that spot." Response shape is identical in either mode; the `mode` field tells the caller which is which so they can label the UI honestly ("This week's forecast" vs "Typical mid-November").

Authentication

AuthorizationBearer

Include your API key as Authorization: Bearer <key>. Contact us for an issued key during the private beta.

Query parameters

latdoubleRequired-90-90

Property latitude.

lngdoubleRequired-180-180

Property longitude.

startdateRequired

Stay start date, ISO YYYY-MM-DD.

enddateRequired

Stay end date (inclusive), ISO YYYY-MM-DD.

Response

Weather data for the requested window.

locationobject

applicableboolean

false when there’s no meaningful data for this coord/date (e.g. marine data on an inland coord). Callers should hide the section in that case rather than showing an empty box.

sourceslist of objects

metaobject

modeenumOptional

forecast when the window is within the 16-day forecast horizon; climatology (10-year historical average for the same date range) beyond.

date_rangeobjectOptional

dailylist of objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

429

Too Many Requests Error

502

Bad Gateway Error