Unemployment datasets
Published by
Covers
Years
Areas
Measures
Each measure is one kind of value you can request, using its id.
| Measure | Unit | Combining areas |
|---|---|---|
Unemployment rateunemployment-rate | % of economically active residents aged 16 and over | Not combined |
Unemployed residentsunemployment-level | unemployed residents aged 16 and over | Adds up |
“Adds up” means you can total it over areas or convert it to other areas. See Measures and periods for why some can't be combined.
Areas and years
Request each of these with its geography and code year as geography and boundaryYear.
| Areas | Code year | Periods | Covers | Records |
|---|---|---|---|---|
| Local authorities | 2019 | 1996-97 to 2021 | England, Wales and Scotland | 369 |
| Local authorities | 2021 | 2020 to 2021 | England, Wales and Scotland | 361 |
Things to know
- Unemployed residents aged 16 and over as a share of the economically active: those in work or looking for it. A rate does not add over areas.
- ONS model-based estimates, combining Annual Population Survey unemployment with the claimant count averaged over twelve months. They are the final edition: ONS discontinued the series in August 2022, and current local estimates are published in its LI01 tables instead.
- Periods to 2003 are financial years, labelled like 1996-97; periods from 2004 are calendar years. Survey responses from January 2020 to March 2022 were reweighted by the publisher in June 2022.
- Buckinghamshire and the two Northamptonshire authorities are served only in the April 2021 partition, and the districts they replaced only in the April 2019 one, so no partition counts anyone twice. The model's estimate for a new authority is its own, and need not equal its districts' combined estimate.
- A sum of these modelled levels is itself an estimate. Its uncertainty is not the sum of its members' intervals, so no interval is given for a sum.
Corrections and improvements
These reviewed changes apply to what the API serves for this data. The publisher's source files are not changed; when a code correction applies, the served record retains the publisher's code as sourceAreaCode.
| Change | What the API serves | Applies when |
|---|---|---|
| Opt-in canonical measure-unit presentation | On the explicit canonical request, each numeric value and any publisher-supplied interval bound is multiplied by the measure's declared scale; the response names the resulting unit and calculation. | GET /v1/data/{measure-id}?units=canonical |
curl "https://api.ukdataatlas.com/v1/corrections?measure=unemployment-rate"/correctionsList reviewed correctionsRequest it
Get the first page of unemployment-rate for local authorities:
curl "https://api.ukdataatlas.com/v1/data/unemployment-rate?period=2021&geography=localAuthority&boundaryYear=2019&limit=5"Read the measure's full definition, including every period it's published for:
curl "https://api.ukdataatlas.com/v1/measures/unemployment-rate"/data/{measure-id}Get observationsget/data/{measure-id}/seriesGet a time seriesSource and licence
| Dataset | Publisher | Licence |
|---|---|---|
| Unemployment | Office for National Statistics | Open Government Licence v3.0 |
Using this data in something you publish? Get attribution text with measure=unemployment-rate returns the credit line to include.
Downloads
Download complete publisher-observation files instead of paging through the API. Each file has a stable hash and covers one measure, period set and source geography. Any reviewed served code correction is documented and retains its publisher code on the affected record. The source and licence information above applies to these files too; preserve the attribution and note any cleaning or reformatting when you redistribute one.
| Measure | Coverage | Records | Download |
|---|---|---|---|
Unemployed residentsunemployment-level | Local authorities · 1996-97 to 2021 · code year 2019 | 9,466 | JSON |
Unemployed residentsunemployment-level | Local authorities · 2020 to 2021 · code year 2021 | 722 | JSON |
Unemployment rateunemployment-rate | Local authorities · 1996-97 to 2021 · code year 2019 | 9,450 | JSON |
Unemployment rateunemployment-rate | Local authorities · 2020 to 2021 · code year 2021 | 722 | JSON |