Skip to navigation

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

AuthorizationBearer

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

Query parameters

latdoubleOptional-90-90

Property latitude. Required unless postcode is provided. If both are given, explicit lat/lng win.

lngdoubleOptional-180-180

Property longitude. Required unless postcode is provided. If both are given, explicit lat/lng win.

postcodestringOptional

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.

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.

Allowed values:
date_rangeobjectOptional
dailylist of objectsOptional

Errors

400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error
502
Bad Gateway Error