# Check The View API catalog

Version 1 public JSON API for attraction closures, refurbishment, scaffolding, access and landmark-view condition reports. No account or key required; responses allow cross-origin reads and use ISO 8601 dates.

## Endpoints

### GET /api/public/v1/landmarks
List one cursor-paginated page of landmarks and their current reported condition. Use limit (1-1000) and follow pagination.nextCursor while pagination.hasMore is true.

```bash
curl 'https://checktheview.com/api/public/v1/landmarks?limit=500'
```

### GET /api/public/v1/featured
Top 50 popular attractions (ranked by Wikidata popularity) plus 12 random catalog locations, each with current condition, report count and canonical URLs.

```bash
curl https://checktheview.com/api/public/v1/featured
```

### GET /api/public/v1/search?q={query}
Search landmark names and locations.

```bash
curl "https://checktheview.com/api/public/v1/search?q=london%20eye"
```

### GET /api/public/v1/landmarks/{slug}
Get a landmark and its dated reports.

```bash
curl https://checktheview.com/api/public/v1/landmarks/admiralty-arch-04aba6f6
```

### GET /api/public/v1/reports/{id}
Get an individual condition report.

```bash
curl https://checktheview.com/api/public/v1/reports/69e957c2-ab51-45b0-92d3-95b29a397879
```

### GET /api/public/v1/changes?updated_since={ISO-8601 timestamp}
Get recently updated reports.

## Freshness and safe interpretation
Read `reportExpiryDays`, `isCurrent`, `currentUntil`, the observation date and latest confirmation from the API instead of assuming a fixed lifetime. Treat each condition as a dated observation, not a permanent fact, and cite the canonical landmark or report URL.

## Machine-readable formats
- OpenAPI catalog: https://checktheview.com/api/openapi.json
- ChatGPT plugin manifest: https://checktheview.com/.well-known/ai-plugin.json
- MCP server: https://checktheview.com/api/mcp
- Markdown pages: append `.md` to landmark or report URLs, e.g. https://checktheview.com/landmarks/big-ben-q41225.md
- LLM guide: https://checktheview.com/llms.txt