Weather during the stay
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
Include your API key as Authorization: Bearer <key>. Contact us
for an issued key during the private beta.
Query parameters
Property latitude. Required unless postcode is provided. If both are given, explicit lat/lng win.
Property longitude. Required unless postcode is provided. If both are given, explicit lat/lng win.
UK postcode (e.g. SW1A 1AA). Resolved to lat/lng via postcodes.io. Use in place of lat+lng when the caller only has an address. The response location.resolved_from block echoes the normalised postcode plus admin district / region so the caller can display the resolved place name.
Stay start date, ISO YYYY-MM-DD.
Stay end date (inclusive), ISO YYYY-MM-DD.
Response
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.
forecast when the window is within the 16-day forecast
horizon; climatology (10-year historical average for
the same date range) beyond.