> 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.

# Chora

Six topics answering "what's around this coordinate, and is any of it
good enough to care about?" Pick the topics you need, compose them
into your product, or embed the whole thing as one HTML widget.

## Topics

#### [Places to Visit](./places-to-visit)

Curated day-trip destinations — RHS Partner Gardens, National Trust
properties, National Trust walks, UNESCO World Heritage Sites,
DarkSky Places, UK museums, and art galleries. 7 endpoints.

#### [Events & Activities](./whats-on)

Ticketed events during the stay, iconic annual festivals, and
bookable tours + attractions. 3 endpoints.

#### [Dining](./dining)

MICHELIN-recognised restaurants tier-ranked by prestige and
distance. 1 endpoint.

#### [Local Wildlife](./wildlife)

Species commonly observed near the coord during the month of the
stay. Aggregated seasonal signal, not a live feed. 1 endpoint.

#### [Weather](./weather-sky)

Weather forecast (or climatology beyond 16 days), sunrise and
sunset, marine, and snow. 4 endpoints.

#### [Journey Planner](./getting-there)

Nearest airports with drive-time estimates and an interactive
directions embed. 1 endpoint.

#### [Widgets](../widgets/embed)

Pre-composed HTML widgets you embed in one `<iframe>`. No auth,
themeable, auto-resizes. 3 endpoints.

## The shared envelope

Every Chora JSON endpoint returns the same envelope, so you can
compose sections uniformly:

```json
{
  "location": { "lat": 51.5074, "lng": -0.1278 },
  "applicable": true,
  "sources": [
    { "provider": "Weather Provider", "url": "https://...", "license": "CC BY 4.0" }
  ],
  "meta": {
    "cached_at": "2026-09-14T18:00:00Z",
    "fresh_until": "2026-09-14T18:10:00Z",
    "partial": false,
    "request_id": "req_abc123"
  },
  "...": "topic-specific payload"
}
```

## Design principles

**Applicable, not empty.** Every endpoint returns an `applicable` flag.
Marine data on an inland coord returns `applicable: false`. Wildlife
data in a low-coverage rural area returns `applicable: false`. Callers
hide the section rather than branching on an error.

**Facts, attributed.** Every response carries a `sources[]` array
naming the upstream provider and license. We republish only facts —
never editorial content or copyrighted images.

**Cached at the edge.** Every response carries a `meta.fresh_until`
timestamp. Weather refreshes every 10 minutes; MICHELIN monthly;
festivals annually. You never need to think about upstream rate limits.

## Composition

Every JSON endpoint is independent. Fan out with `Promise.all` and
filter to what applies:

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

const applicable = responses.filter(r => r.applicable);
```

Or embed the pre-composed HTML widget in one `<iframe>` — see
[Embed the widget](/widgets/embed-the-widget).