34 endpoints

Areas & boundaries

Everything about the areas themselves: codes and names, boundary releases, map tiles, how areas nest and overlap, and how codes change over time.

• List map resourcesList the boundary releases that are ready to draw as vector tiles. Releases are tiled deliberately, not automatically, so this list is short.get/map-resources
• Get a map resourceEverything you need to draw one boundary release: the tile and archive URLs, zoom levels, where the shapes came from and the attribution to show beside your map.get/map-resources/{geography}/{release}
• Get TileJSONThe TileJSON 3.0 document you give a map library like MapLibre, including the attribution your map needs to display.get/map-resources/{geography}/{release}/tiles.json
• Download shapes as GeoParquetEvery area of a boundary release in one GeoParquet file, ready for DuckDB, BigQuery, QGIS or GeoPandas. The shapes match the tiles exactly, borders included, and each row carries the same id and code, so values join straight on.get/map-resources/{geography}/{release}/features
• Get a vector tileOne Mapbox Vector Tile of boundaries. Each feature carries the area's code, its name and a numeric id. Values aren't baked in, so one set of tiles works for every measure.get/map-resources/{geography}/{release}/tiles/{z}/{x}/{y}.mvt
• Get values for tilesA small table of one measure's values, keyed by the same numeric id the tiles use, so your map can colour areas without touching the shapes.get/map-resources/{geography}/{release}/join/{measure-id}
• Download all tilesEvery tile for a boundary release in a single PMTiles file. Host it on a CDN, or use it offline.get/map-resources/{geography}/{release}.pmtiles
• List geographiesList the kinds of area the Atlas knows about, such as wards, local authorities and constituencies, each with its latest boundary release.get/geographies
• List boundary releasesList every set of boundaries the Atlas has compiled, across all geographies and dates.get/boundary-releases
• Find boundaries for a dateWhich local authority boundaries should you use for June 2023? Give a geography and a date and get an exact boundary release id back, along with the releases just before and after it.get/boundary-releases:resolve
• Compare boundary releasesCompare two releases of one geography and see which codes are shared, added or absent. Where published same-code evidence exists, it also reports whether an area's boundary stayed continuous, changed or remains indeterminate.get/boundary-releases:compare
• Get a boundary releaseGet the details of one boundary release: who published it, under what licence, and which countries it covers.get/boundary-releases/{geography}/{release}
• Join your rows to a releaseSend your own area codes or names and values, then receive the rows matched to one boundary release and keyed by the numeric id its tiles use.post/boundary-releases/{geography}/{release}:join
• List areasPage through areas, optionally narrowed to one geography and boundary release.get/areas
• Check codes or namesGot a spreadsheet column of area codes or names? Check up to 500 at once against a boundary release before you join data to it. Each comes back as valid, superseded, ambiguous and so on, with the reason.get/areas:validate
• Validate a whole columnValidate up to 250,000 area codes or names from a JSON or CSV request body before joining data to a boundary release.post/areas:validate
• Get an areaLook up one area by its geography, boundary release and code, and get its name and any aliases.get/areas/{geography}/{release}/{code}
• Get an area's relationshipsSee how an area relates to others through published crosswalks: what it sits within, what it contains, what it replaced or was replaced by, and what it overlaps.get/areas/{geography}/{release}/{code}/relationships
• Get an area's historyTrace an area through time: what it replaced, what replaced it, and which other boundary releases use the same code.get/areas/{geography}/{release}/{code}/history
• List parent areasList the published areas this one sits wholly inside.get/areas/{geography}/{release}/{code}/parents
• List child areasList the published areas that sit wholly inside this one, like the wards in a local authority.get/areas/{geography}/{release}/{code}/children
• Check relationship healthA release-by-release summary of how well connected the Atlas's geographies are: how many areas in each have published relationships, and how many are still on their own. Filter with geography or country to narrow it.get/geography-health
• Explore geography relationshipsUse one route to discover conversions from a release, inspect a specific source and target pair, choose a path for an intended operation, or find relationship coverage gaps.get/relationships
• List crosswalksA crosswalk maps one set of areas onto another, such as wards to local authorities, or 2010 constituencies to 2024 ones. This lists every crosswalk the Atlas publishes.get/crosswalks
• Get a crosswalkFind out how a crosswalk was made and how reliable it is, without downloading its full list of mappings.get/crosswalks/{crosswalk-id}
• List crosswalk mappingsPage through a crosswalk's mappings, or filter them to one source area.get/crosswalks/{crosswalk-id}/records
• Translate an area codeTurn a code in one geography into its match in another: a ward into its local authority, or an old constituency into its 2024 successor.get/translations
• List named locationsNamed locations are handy groupings the official geographies don't have, like "North Wales" or "Greater Manchester". Search them by name with q.get/locations
• Compare location definitionsA real-world name can have several curated definitions. Give its exact name to see each one, its kind and the source that distinguishes it.get/locations/alternatives
• Get a named locationGet one named location's description, the area codes it's made from and its bounds.get/locations/{location-id}
• Compare location membershipsSee which member codes a named location kept, gained or lost between two dates.get/locations/{location-id}/comparison
• Get a named location's shapeDownload a named location's outline, such as Greater Manchester, as one GeoJSON Feature: its member areas merged into a single shape.get/locations/{location-id}/geometry
• List a named location's areasList the areas that make up a named location in a boundary release you choose, such as the wards of North Wales. Anything that can't be matched is listed too, with the reason.get/locations/{location-id}/members
• Find what a named location sits inThe other way round from listing its areas: which regions, counties or combined authorities a named location falls in, and whether it covers each one whole or only part of it.get/locations/{location-id}/parents