Download an atlas lookup

Download one of the lookups the atlas map reads: where each ward, LSOA and parish sits, which authorities each constituency overlaps, and where each area went between boundary releases.

get
/atlas-lookups/{lookup-id}.json

Good to know

  • Name the lookup in the path, such as /v1/atlas-lookups/area-lineage.json. An unknown id returns 404.
  • Each file follows the atlas's own shape, so it may change with the atlas. For a stable contract, use the crosswalk and area routes.
  • lookup-idstringrequired

Returns

object

The exact JSON build artifact.

  • 404No resource matches that identity.
  • 503The referenced build artifact has not been built yet.

Every error has the same shape. See Errors for how to handle them.

Show the precise behaviour

The web atlas cannot hold the crosswalks, so the build reduces them to compact lookups for the boundary releases the atlas draws, as the geography resolver answers them. Available ids are area-lineage (where each ward, local authority and constituency goes between releases), boundary-mappings (each ward's local authority and constituency), constituency-lad-overlaps (the share of each constituency every local authority holds), parish-lad-mappings and lsoa-lad-mappings-{year} for each LSOA year the atlas draws, such as lsoa-lad-mappings-2021. Their shapes follow the atlas and may change with it; the crosswalks and relationship routes are the stable way to ask the same questions.