{"openapi":"3.1.0","info":{"title":"Check The View public API","version":"1.0.0","description":"Live, dated traveller reports and approved official updates about attraction closures, refurbishment, scaffolding, restricted access and landmark views worldwide. Reports are dated observations, not permanent facts; check freshness fields (isCurrent, currentUntil, reportExpiryDays) and cite the canonical landmark or report URL.","contact":{"name":"Jamie Olney","url":"https://jamieolney.co.uk/","email":"jamie@jamieolney.co.uk"},"license":{"name":"Open data with attribution","url":"https://checktheview.com/data"}},"servers":[{"url":"https://checktheview.com"}],"paths":{"/api/public/v1/landmarks":{"get":{"summary":"List a page of landmarks and their current reported condition","description":"Returns a cursor-paginated page of landmarks with current condition, latest observation date, report counts and canonical URLs. Follow pagination.nextCursor while pagination.hasMore is true.","operationId":"listLandmarks","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size from 1 to 1000; defaults to 500.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":500}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor returned in pagination.nextCursor.","schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated landmark list"},"400":{"description":"Invalid limit or cursor"}}}},"/api/public/v1/featured":{"get":{"summary":"Top popular and random landmarks","description":"Returns the 50 most popular landmarks ranked by Wikidata popularity plus 12 random catalog locations, each with current condition, report count and canonical URLs.","operationId":"getFeaturedLandmarks","responses":{"200":{"description":"Featured landmark lists"}}}},"/api/public/v1/search":{"get":{"summary":"Search landmarks by name or location","operationId":"searchLandmarks","parameters":[{"name":"q","in":"query","required":true,"description":"Search term (2-100 characters).","schema":{"type":"string"}}],"responses":{"200":{"description":"Matching landmarks"},"400":{"description":"Invalid query"}}}},"/api/public/v1/landmarks/{slug}":{"get":{"summary":"Get one landmark with its dated reports","operationId":"getLandmark","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Landmark detail"},"404":{"description":"Not found"}}}},"/api/public/v1/reports/{id}":{"get":{"summary":"Get an individual condition report","operationId":"getReport","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Report detail"},"404":{"description":"Not found"}}}},"/api/public/v1/changes":{"get":{"summary":"Get reports updated since a timestamp","operationId":"getChanges","parameters":[{"name":"updated_since","in":"query","required":false,"description":"ISO 8601 timestamp.","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Recently updated reports"}}}}}}