Office for National Statistics
StatisticsGBapi.beta.ons.gov.uk
UK official statistics: the ONS dataset catalogue and the editions and versions behind each one.
Capabilities (17)
GET /v1/data/ons/area-types1 creditReturns the geography levels a population type can be tabulated at, from England and Wales down to output areas, each with its id, label and how many areas it contains.
GET /v1/data/ons/census-observations1 creditReturns Census 2021 counts for a population type, cross-tabulated by the requested variables at the requested geography level, each row naming its dimension options and the count.
GET /v1/data/ons/code-list-editions1 creditReturns the editions of one code list, each with its edition name and a link to the codes it contains.
GET /v1/data/ons/code-lists1 creditReturns every classification code list ONS publishes, each with its id and links to its editions and codes.
GET /v1/data/ons/codes1 creditReturns the codes of one code list edition, each with its code, human label and a link to the datasets that use it.
GET /v1/data/ons/dataset1 creditReturns one dataset's record: title, description, keywords, national-statistic flag, release frequency, contact details, licence and links to its editions and latest version.
GET /v1/data/ons/datasets1 creditReturns the catalogue of ONS published datasets, each with id, title, description, keywords, contacts, release frequency and a link to its latest version.
GET /v1/data/ons/dimension-options1 creditReturns the valid option codes and labels for one dimension of a dataset version, each linked to its entry in the underlying code list.
GET /v1/data/ons/dimensions1 creditReturns the dimensions of one dataset version, each with its label, its options endpoint and the code list that defines its values.
GET /v1/data/ons/edition1 creditReturns one edition of a dataset, with its internal id and an explicit pointer to the current latest version number.
GET /v1/data/ons/editions1 creditReturns the editions of one dataset, each with its edition name and a link to the current latest version of that edition.
GET /v1/data/ons/observations1 creditReturns the actual observation values of a dataset version for one combination of dimension options, with the unit of measure and the total observation count.
GET /v1/data/ons/population-type-dimensions1 creditReturns the census variables that can be crossed for one population type, each with its id, label, category count and a long plain-English description.
GET /v1/data/ons/population-types1 creditReturns the census population bases available for Census 2021 tabulation, each with its short name, label, description and whether it is microdata or tabular.
GET /v1/data/ons/search1 creditSearches ONS published content and returns scored results with title, summary, release date, content type and URI, alongside topic and content-type facet counts.
GET /v1/data/ons/version-metadata1 creditReturns the statistical metadata of one dataset version: dimension list, unit of measure, release date and frequency, methodology and quality-statement links, licence, and the CSV/XLSX download URLs with their byte sizes.
GET /v1/data/ons/versions1 creditReturns every published version of one dataset edition, each with its version number, release date, any correction or alert notices, and download links.
Licence
Open Government Licence v3.0
https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/Attribution
Display this wherever you show the data. It arrives on every response as provenance.attribution_text.
Contains public sector information licensed under the Open Government Licence v3.0.
Cache: up to 3600s
