Introduction

UK Data Atlas API

Official statistics for every corner of the UK, from population and pay to broadband and air quality, ready to drop into your apps, maps and analysis.

Coming soon. The API isn't live yet, so details may change.

What you can do

Why the API exists

UK public data is fragmented, inconsistent, and often difficult to use. Boundaries change between years, location codes and names go missing, and datasets across England, Wales, Scotland and Northern Ireland rarely line up cleanly.

While building the UK Data Atlas, we collected, cleaned, repaired and standardised this data ourselves. The API makes that work available to everyone, giving you one consistent way to access UK public datasets, boundaries and geographic mappings without having to clean them first.

Why it's different

  • Nothing is guessed. Values come back exactly as they were published. If something needs converting or adding up, you ask for that explicitly.
  • Every answer shows its working. Responses say which areas, boundaries and period they describe, and which release of the Atlas produced them.
  • It says no rather than mislead. Ask for an average of medians and you'll get a clear explanation, not a number that looks right but isn't.

Try a question

Ask for a statistic in the language you use, then see the request and response the API would return.

Ask a question
curl "https://api.ukdataatlas.com/v1/data/population/value?place=North%20West&period=2022"
Get an answer
{
  "apiVersion": "v1",
  "atlasRelease": "sha256:24a500c55416bd7d58c28b1fc8cc4931d4a2fd831addafa3116556a91f2c4857",
  "data": {
    "measure": {
      "id": "population",
      "label": "Population estimate",
      "valueKind": "count",
      "unit": "people"
    },
    "question": {
      "place": "North West",
      "period": "2022",
      "placeDefaulted": false
    },
    "answer": {
      "period": "2022",
      "periodDefaulted": false,
      "status": "derived",
      "value": 7526285,
      "unit": "people"
    },
    "place": {
      "place": "location/north-west",
      "kind": "named-location",
      "name": "North West",
      "geography": "named-location",
      "code": "north-west",
      "match": "exact"
    },
    "method": "aggregate",
    "via": "/v1/data/population/aggregate?place=location/north-west&geography=localAuthority&boundaryYear=2023&period=2022",
    "otherMatches": [
      {
        "place": "region/E12000002",
        "kind": "area",
        "name": "North West",
        "geography": "region",
        "code": "E12000002",
        "match": "exact",
        "served": false,
        "reason": "population is not published for region areas."
      }
    ]
  },
  "meta": {
    "nextCursor": null
  }
}