> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.trychora.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.trychora.com/_mcp/server.

# Weather

Four endpoints that answer "what will the elements be doing while my
guests are here?" All four share the same argument shape —
`?lat=..&lng=..&start=YYYY-MM-DD&end=YYYY-MM-DD` — so you can request
them in parallel and render whichever apply.

## Endpoints

#### [Weather](/api-reference/api-reference/weather)

Daily forecast within 16 days, climatology (10-year historical
average) beyond. Same shape either way; a `mode` field tells you
which.

#### [Sunrise & sunset](/api-reference/api-reference/weather)

Sunrise and sunset times for each day of the stay. Useful for
photography timing, early-arrival planning, and setting daylight
expectations.

#### [Marine](/api-reference/api-reference/weather)

Sea surface temp, wave height, swell. Coastal only — inland coords
return `applicable: false`.

#### [Snow](/api-reference/api-reference/weather)

Snowfall + snow depth for the stay. Alpine only — properties with
no historical accumulation return `applicable: false`.

## Example: compose all four in parallel

```js
const params = new URLSearchParams({ lat, lng, start, end }).toString();
const [weather, astronomy, marine, snow] = await Promise.all([
  fetch(`/v1/chora/weather?${params}`,   { headers }).then(r => r.json()),
  fetch(`/v1/chora/astronomy?${params}`, { headers }).then(r => r.json()),
  fetch(`/v1/chora/marine?${params}`,    { headers }).then(r => r.json()),
  fetch(`/v1/chora/snow?${params}`,      { headers }).then(r => r.json()),
]);

const applicable = [weather, astronomy, marine, snow].filter(s => s.applicable);
```

## Data sources

All four are sourced from a public weather data provider under CC BY
4.0. See [Attribution](/technical-concepts/attribution) for the full source list.