Economic output datasets
Published by
Covers
Years
Areas
Measures
Each measure is one kind of value you can request, using its id.
| Measure | Unit | Combining areas |
|---|---|---|
Gross value addedgva | £ million | Adds up |
Gross domestic productgdp | £ million | 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 |
|---|---|---|---|---|
| ITL1 regions | 2025 | 1998 to 2023 | UK | 12 |
| ITL2 areas | 2025 | 1998 to 2023 | UK | 46 |
| ITL3 areas | 2025 | 1998 to 2023 | UK | 182 |
Things to know
- Balanced gross value added at current basic prices: the output of an area before taxes on products are added and subsidies taken off. It is not comparable with the national GDP figure; use gdp for that.
- Values are in cash terms for the year observed, not adjusted for inflation, so a rise between two periods is not a rise in real output.
- The three ITL tiers nest, so an ITL3 area sits inside an ITL2 area inside an ITL1 area. Each tier is a separate source partition; areas may be summed within one tier, never across tiers.
- Output per head is not served. It is a ratio, so it cannot be summed over areas, and the publisher's population basis for it is the regional accounts one rather than the mid-year estimates this API serves.
- Output is measured where it is produced, not where the people who earn it live, so an area that many commute into records output they do not live beside.
- Gross domestic product at current market prices: balanced gross value added plus taxes on products less subsidies on them, allocated to areas by the publisher. This is the regional figure comparable with the national accounts.
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=gva"/correctionsList reviewed correctionsRequest it
Get the first page of gva for itl1 regions:
curl "https://api.ukdataatlas.com/v1/data/gva?period=2023&geography=itl1&boundaryYear=2025&limit=5"Read the measure's full definition, including every period it's published for:
curl "https://api.ukdataatlas.com/v1/measures/gva"/data/{measure-id}Get observationsget/data/{measure-id}/seriesGet a time seriesSource and licence
| Dataset | Publisher | Licence |
|---|---|---|
| Regional gross domestic product: ITL1 regions | Office for National Statistics | Open Government Licence v3.0 |
| Regional gross domestic product: ITL2 regions | Office for National Statistics | Open Government Licence v3.0 |
| Regional gross domestic product: ITL3 regions | Office for National Statistics | Open Government Licence v3.0 |
Using this data in something you publish? Get attribution text with measure=gva 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 |
|---|---|---|---|
Gross domestic productgdp | ITL1 regions · 1998 to 2023 · code year 2025 | 312 | JSON |
Gross domestic productgdp | ITL2 areas · 1998 to 2023 · code year 2025 | 1,196 | JSON |
Gross domestic productgdp | ITL3 areas · 1998 to 2023 · code year 2025 | 4,732 | JSON |
Gross value addedgva | ITL1 regions · 1998 to 2023 · code year 2025 | 312 | JSON |
Gross value addedgva | ITL2 areas · 1998 to 2023 · code year 2025 | 1,196 | JSON |
Gross value addedgva | ITL3 areas · 1998 to 2023 · code year 2025 | 4,732 | JSON |