Sheffield Events public API

Endpoints

Every response is an envelope: data, meta (counts and paging), sources (name, licence, attribution, updated) and citation (a URL you can quote). Field selection: fields=a,b,c. Paging: page and per_page (max 100).

• https://sheff.events/api/areasThe 147 neighbourhoods with counts. q= filters by name.
• https://sheff.events/api/areas/city-centreOne neighbourhood: counts, Census 2021 shares, sold prices, constituency, neighbours.
• https://sheff.events/api/areas/locate?lat=53.3811&lng=-1.4701Which neighbourhood and constituency a point is in, with the nearest stops.
• https://sheff.events/api/events?from=2026-10-09&per_page=10Upcoming events. q, from, to, area, category, lat, lng, radius, classes.
• https://sheff.events/api/events/{id}One event with venue, times, price flags, canonical URL and source.
• https://sheff.events/api/places?q=theatreBusinesses and venues from the directory. kind=business|location, lat, lng, radius.
• https://sheff.events/api/services?kind=pharmacy&lat=53.3811&lng=-1.4701GP practices, pharmacies, dentists, libraries, family hubs, housing offices, foodbanks, community venues and schools.
• https://sheff.events/api/stops/nearest?lat=53.3811&lng=-1.4701NaPTAN stops with walk times. Stop records, not departures.
• https://sheff.events/api/sourcesEvery data source with licence, credit, freshness and status.
• https://sheff.events/api/dataOpen data: bulk downloads of every redistributable dataset as JSON, CSV, NDJSON or GeoJSON, and everything inside one neighbourhood. See Open data below.
• https://sheff.events/api/layersPublic Local Map layers and their data URLs.
• https://sheff.events/api/teamsSheffield sports teams and grounds.
• https://sheff.events/api/fixtures?competition=championshipFixtures and results by competition or team.
• https://sheff.events/api/mpsThe six constituencies, their MPs and recent activity.

MCP

Agents can use the same facts through a read-only Model Context Protocol server with no authentication:

https://sheff.events/api/mcp

It exposes these abilities as tools:

• sheff-events/search-events Upcoming Sheffield events by keyword, date window, neighbourhood or area tag, category, and distance from a point. Returns canonical URLs and each event's source.
• sheff-events/get-event One published event with venue, times, categories, price flags, canonical URL and source.
• sheff-events/search-places Businesses and venues in the Sheffield Events directory by keyword or distance, with conservative location fields.
• sheff-events/get-area Facts for one of the 147 Sheffield neighbourhoods: counts, census shares, sold prices, constituency and links.
• sheff-events/list-areas All Sheffield neighbourhoods with counts, optionally filtered by name.
• sheff-events/locate Which neighbourhood and constituency a latitude and longitude fall in, with the nearest stops.
• sheff-events/nearest-services GP practices, pharmacies, dentists, libraries, family hubs, housing offices, foodbanks, community venues and schools near a point or by keyword.
• sheff-events/nearest-stops NaPTAN stop records near a point with walk times. Not live departures.
• sheff-events/list-map-layers Metadata for the public Local Map layers and where to fetch each.
• sheff-events/source-health Every public data source behind Sheffield Events with licence, credit, freshness and status. Never internal error text.
• sheff-events/list-mps The six constituencies covering Sheffield, their MPs and recent Parliamentary activity, with official record links.
• sheff-events/list-teams Sheffield sports teams with grounds and competitions.
• sheff-events/data-catalogue Every data provider behind Sheffield Events with licence, attribution, source, last refresh, record count, and whether its records are redistributed here (open licences only) with the download endpoints.
• sheff-events/data-rows The stored records of one redistributable provider (optionally one part), flattened, with paging. Returns an error for providers whose licence does not allow redistribution.
• sheff-events/area-scores Every Sheffield neighbourhood scored 0 to 100 on quiet, green, connected, affordable, safe, lively and served (percentile ranks across neighbourhoods, derived from open data, CC BY 4.0), with the overall score, rank, must-have flags (tram stop, GP, primary school, park within reach) and, when asked, the inputs behind every dimension with value, unit, source and licence. A dimension with fewer than two inputs is null.
• sheff-events/area-data For one of the 147 Sheffield neighbourhoods: every redistributable record with a point inside its polygon, grouped by provider and part, plus the derived census, sold price, broadband, monthly sales and correlation figures the neighbourhood page computes.
• sheff-events/marketing-kit Ready-to-post marketing materials for any published event or page: social images in every size with alt text, A4 and A5 PDF flyers, suggested copy and hashtags per network, and one zip URL with everything in folders. Free to use to promote the listing.
• sheff-events/marketing-image One marketing image for a published event or page. Formats: og (1200×630 link card), square (1080×1080), portrait (1080×1350), story (1080×1920). Returns the image URL, size and alt text.

Nothing on this server writes, refreshes a source or reaches an upstream provider. Member and organiser actions stay on the authenticated site.

Members

A second, authenticated MCP server lets a signed-in member work with their own saves, plan, follows, notification preferences, conversations and submissions, plus everything public. Authenticate with a WordPress application password from your account settings; every call acts only as you, on your own records, is rate-limited, and is written to a log you can read back with my-activity-log.

https://sheff.events/api/member-mcp

• sheff-events/data-follows
• sheff-events/follow-data
• sheff-events/me
• sheff-events/my-saves
• sheff-events/save-event
• sheff-events/unsave-event
• sheff-events/my-plan
• sheff-events/plan-add
• sheff-events/plan-remove
• sheff-events/my-follows
• sheff-events/follow
• sheff-events/unfollow
• sheff-events/notification-preferences
• sheff-events/update-notification-preferences
• sheff-events/my-notifications
• sheff-events/my-conversations
• sheff-events/send-message
• sheff-events/my-submissions
• sheff-events/submit-event
• sheff-events/my-activity-log
• sheff-events/update-event
• sheff-events/submit-business
• sheff-events/update-business
• sheff-events/submit-job
• sheff-events/update-job
• sheff-events/withdraw-listing

Organiser abilities change only listings you submitted (editors can change any). Submissions and a member's edits to a live listing enter review; withdraw-listing previews unless confirm is true and only ever moves a listing to draft.

Open data

Every dataset the site holds is available as a bulk download, with the licence and credit of the source carried through, so a student, journalist or council officer can take one neighbourhood's whole picture in a single call. Only providers whose licence allows redistribution (Open Government Licence, CC0, CC BY, CC BY-SA, ODbL, Open Parliament Licence, public domain, and the site's own data) are served; the rest are listed with their licence and marked not redistributed, and their data endpoints answer 403 with the reason.

• https://sheff.events/api/dataThe catalogue: every provider with licence, attribution, source, last refresh, record count, parts and download URLs.
• https://sheff.events/api/data/deprivationEvery stored record of one provider, flattened (parts are merged with a part field). page, per_page (0 = everything, up to 20,000), fields, format=json|csv|ndjson|geojson.
• https://sheff.events/api/data/listed/listed?format=geojson&per_page=0One part of a provider. GeoJSON is offered when records carry lat and lng or polygon rings.
• https://sheff.events/api/data/deprivation/chart/decilesA connector's chart series (labels, series, unit, style) as JSON, or format=csv.
• https://sheff.events/api/areas/crookes/dataEverything inside one neighbourhood: every redistributable record whose point falls in the polygon, grouped by provider and part, plus the derived census, price, broadband, monthly sales, correlation and scorecard figures. format=json|csv|geojson.
• https://sheff.events/api/areas/scores?workings=1Every neighbourhood's scorecard: quiet, green, connected, affordable, safe, lively and served as 0 to 100 percentile ranks, the overall score and must-have flags; workings=1 adds every input with value, unit, source and licence. Derived data, CC BY 4.0. format=json|csv.

Examples

curl -s 'https://sheff.events/api/data' | jq '.data[] | select(.redistributed) | .key'
curl -sL 'https://sheff.events/api/data/sewage?format=csv&per_page=0' -o sheffield-storm-overflows.csv
curl -s 'https://sheff.events/api/data/osm_amenities/gbptm?format=geojson&per_page=0' -o toilets.geojson
curl -s 'https://sheff.events/api/areas/crookes/data' | jq '.data.point_counts, .data.derived.comparisons'
curl -s 'https://sheff.events/api/data/healthstats/chart/le_male?format=csv'
curl -s -H 'If-None-Match: "<etag>"' -o /dev/null -w '%{http_code}' 'https://sheff.events/api/data/fsa'

How the data gets here

• What we fetch: published open datasets about Sheffield from official and community publishers (Environment Agency, ONS, HM Land Registry, NHS, Historic England, Natural England, OpenStreetMap, Wikidata and others). Every provider, its source URL, licence and budget is on the sources page.
• How often: each provider has its own schedule, from every 15 minutes for live sensors to quarterly for the census, run by the site's own cron with the fewest requests the source allows. No page you open ever calls a provider in your browser.
• What we store: a validated snapshot of the latest good response per provider, kept until the next successful refresh. Snapshots hold organisations, places, readings and public records; no personal data about site members is ever in them, and these endpoints never read member data.
• How neighbourhoods are computed: the 147 Data for Action neighbourhood polygons (CC BY 4.0). A record belongs to a neighbourhood when its point is inside the polygon (even-odd rule, holes excluded); neighbourhoods smaller than a census area borrow the nearest area's figures and say so.
• How we correlate: derived figures are simple and stated. Examples: median sold price is the median of standard Land Registry sales placed in the polygon over twelve whole months; census shares are sums of the LSOA tables whose population-weighted centroid falls inside; the comparisons are Pearson r across neighbourhoods with their own census area and at least 800 adults, and are patterns across places, never causes and never about one street.
• How to cite: quote citation.url from the envelope and the citation_text line, for example "Data from Yorkshire Water storm overflows (EDM), CC BY 4.0, via Sheffield Events (sheff.events), retrieved 2026-09-14". The source keeps its licence; Sheffield Events' derived figures are CC BY 4.0 (meta.derived_licence). CSV downloads carry the same lines as leading # comments and every response sends a Link: rel="license" header.
• How to report a problem: if a record is wrong, out of date or should not be here, use the contact form in the footer with the endpoint URL and the record id, or comment on the sources page; corrections that need the publisher are passed on and the snapshot is refreshed once they publish.

Data responses are cached publicly for an hour and carry ETags; send If-None-Match to get a 304. The same rate budget as the rest of the API applies, so fetch a whole provider with per_page=0 once and cache it rather than paging repeatedly.

Errors and limits

• Not found: 404 with code sheff_*_not_found.
• Bad input: 400 with code sheff_bad_*.
• Layer without data yet: 503.
• Over budget: 429 with Retry-After.
• Send If-None-Match with the ETag you were given to get a 304 when nothing changed.

Licences

Each source keeps its own licence and asks for its own credit; both are in every response and on the sources page. Quote the citation URL when you use a result. All data sources