{"openapi":"3.1.0","info":{"title":"UK Statistics API","version":"1.0.0","description":"Official UK economic statistics straight from the Office for National Statistics (ONS) beta API — no key, read live. The cpi endpoint returns CPIH, the UK's lead measure of consumer price inflation (Consumer Prices Index including owner occupiers' housing costs, index 2015=100), for the latest month with the index level plus the month-on-month and year-on-year rates, computed from the official series. The cpi/series endpoint returns the historical monthly CPIH index and year-on-year rate over the last N months, ready to chart. The cpi/divisions endpoint breaks the latest CPIH down across all twelve COICOP divisions (food, housing, transport, recreation and so on) with the index for each. The datasets endpoint lists the ONS dataset catalogue (hundreds of datasets covering prices, GDP, the labour market, population, trade and more) so you can discover what is available. The meta endpoint documents the source. Live data from the ONS beta CMD API, lightly cached. Live. 5 endpoints. This serves UK national statistics; for the sterling exchange rate or the Bank of England base rate use an FX / central-bank API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/uk-stats-api","description":"oanor gateway"}],"tags":[{"name":"Inflation"},{"name":"Catalogue"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/cpi":{"get":{"operationId":"get_v1_cpi","tags":["Inflation"],"summary":"UK CPIH (latest month): index, MoM and YoY","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"Index: 2015=100","index":139.4,"period":"Jan-26","source":"UK Office for National Statistics (dataset cpih01)","country":"United Kingdom","indicator":"CPIH — Consumer Prices Index including owner occupiers' housing costs (overall)","period_iso":"2026-01","change_mom_pct":-0.36,"change_yoy_pct":3.18},"meta":{"timestamp":"2026-06-15T20:40:38.079Z","request_id":"fd383c9f-2e6e-473d-8ba9-76095c4dc9dc"},"status":"ok","message":"UK CPIH retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cpi/divisions":{"get":{"operationId":"get_v1_cpi_divisions","tags":["Inflation"],"summary":"Latest CPIH across all 12 COICOP divisions","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"Index: 2015=100","count":12,"period":"Jan-26","source":"ONS cpih01","country":"United Kingdom","divisions":[{"index":144.3,"label":"01 Food and non-alcoholic beverages","coicop":"CP01"},{"index":159.7,"label":"02 Alcoholic beverages and tobacco","coicop":"CP02"},{"index":118,"label":"03 Clothing and footwear","coicop":"CP03"},{"index":142.8,"label":"04 Housing, water, electricity, gas and other fuels","coicop":"CP04"},{"index":124.5,"label":"05 Furniture, household equipment and maintenance","coicop":"CP05"},{"index":142.3,"label":"06 Health","coicop":"CP06"},{"index":136.7,"label":"07 Transport","coicop":"CP07"},{"index":142.1,"label":"08 Communication","coicop":"CP08"},{"index":135.5,"label":"09 Recreation and culture","coicop":"CP09"},{"index":152.7,"label":"10 Education","coicop":"CP10"},{"index":150.7,"label":"11 Restaurants and hotels","coicop":"CP11"},{"index":124.3,"label":"12 Miscellaneous goods and services","coicop":"CP12"}],"indicator":"CPIH by COICOP division","period_iso":"2026-01"},"meta":{"timestamp":"2026-06-15T20:40:38.171Z","request_id":"65078bc9-b993-43b4-86df-abc0ed22a5d3"},"status":"ok","message":"UK CPIH by division retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cpi/series":{"get":{"operationId":"get_v1_cpi_series","tags":["Inflation"],"summary":"Historical CPIH index + YoY series","description":"","parameters":[{"name":"months","in":"query","required":false,"description":"Number of recent months (default 24, max 240)","schema":{"type":"string"},"example":"24"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"Index: 2015=100","count":24,"series":[{"index":130.8,"period":"Feb-24","period_iso":"2024-02","change_yoy_pct":3.81},{"index":131.6,"period":"Mar-24","period_iso":"2024-03","change_yoy_pct":3.79},{"index":132.2,"period":"Apr-24","period_iso":"2024-04","change_yoy_pct":3.04},{"index":132.7,"period":"May-24","period_iso":"2024-05","change_yoy_pct":2.79},{"index":133,"period":"Jun-24","period_iso":"2024-06","change_yoy_pct":2.78},{"index":132.9,"period":"Jul-24","period_iso":"2024-07","change_yoy_pct":3.02},{"index":133.4,"period":"Aug-24","period_iso":"2024-08","change_yoy_pct":3.09},{"index":133.5,"period":"Sep-24","period_iso":"2024-09","change_yoy_pct":2.61},{"index":134.3,"period":"Oct-24","period_iso":"2024-10","change_yoy_pct":3.15},{"index":134.6,"period":"Nov-24","period_iso":"2024-11","change_yoy_pct":3.54},{"index":135.1,"period":"Dec-24","period_iso":"2024-12","change_yoy_pct":3.52},{"index":135.1,"period":"Jan-25","period_iso":"2025-01","change_yoy_pct":3.92},{"index":135.6,"period":"Feb-25","period_iso":"2025-02","change_yoy_pct":3.67},{"index":136.1,"period":"Mar-25","period_iso":"2025-03","change_yoy_pct":3.42},{"index":137.7,"period":"Apr-25","period_iso":"2025-04","change_yoy_pct":4.16},{"index":138,"period":"May-25","period_iso":"2025-05","change_yoy_pct":3.99},{"index":138.4,"period":"Jun-25","period_iso":"2025-06","change_yoy_pct":4.06},{"index":138.5,"period":"Jul-25","period_iso":"2025-07","change_yoy_pct":4.21},{"index":138.9,"period":"Aug-25","period_iso":"2025-08","change_yoy_pct":4.12},{"index":138.9,"period":"Sep-25","period_iso":"2025-09","change_yoy_pct":4.04},{"index":139.5,"period":"Oct-25","period_iso":"2025-10","change_yoy_pct":3.87},{"index":139.4,"period":"Nov-25","period_iso":"2025-11","change_yoy_pct":3.57},{"index":139.9,"period":"Dec-25","period_iso":"2025-12","change_yoy_pct":3.55},{"index":139.4,"period":"Jan-26","period_iso":"2026-01","change_yoy_pct":3.18}],"source":"ONS cpih01","country":"United Kingdom","indicator":"CPIH overall monthly series"},"meta":{"timestamp":"2026-06-15T20:40:38.250Z","request_id":"978aecb9-270a-4f89-92a0-20e0277ef88c"},"status":"ok","message":"UK CPIH series retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/datasets":{"get":{"operationId":"get_v1_datasets","tags":["Catalogue"],"summary":"List the ONS dataset catalogue","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of datasets to list (default 50, max 200)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"source":"UK Office for National Statistics","datasets":[{"id":"wellbeing-quarterly","title":"Quarterly personal well-being estimates","description":"Seasonally and non seasonally-adjusted quarterly estimates of life satisfaction, feeling that the things done in life are worthwhile, happiness and anxiety in the UK."},{"id":"wellbeing-local-authority","title":"Personal well-being estimates by local authority","description":"Estimates of life satisfaction, feeling that the things done in life are worthwhile, happiness and anxiety at the UK, country, regional, county, local and unitary authority level."},{"id":"weekly-deaths-region","title":"Deaths registered weekly in England and Wales by region","description":"Provisional counts of the number of deaths registered in England and Wales, by region, in the latest weeks for which data are available."},{"id":"weekly-deaths-local-authority","title":"Death registrations and occurrences by local authority and place of death","description":"Provisional counts of the number of deaths registered in England and Wales, including deaths involving the coronavirus (COVID-19), by local authority, health board and place of death in the latest wee"},{"id":"weekly-deaths-health-board","title":"Death registrations and occurrences by health board and place of death","description":"Provisional counts of the number of deaths registered in Wales, by health board and place of death, in the latest weeks for which data are available."},{"id":"weekly-deaths-age-sex","title":"Deaths registered weekly in England and Wales by age and sex","description":"Provisional counts of the number of deaths registered in England and Wales, by age and sex, in the latest weeks for which data are available."},{"id":"uk-spending-on-cards","title":"UK spending on credit and debit cards","description":"These data series are experimental faster indicators for monitoring UK spending using debit and credit cards."},{"id":"uk-business-by-enterprises-and-local-units","title":"UK Business: Activity, Size and Location","description":"The data contained in these tables are numbers of enterprises and local units produced from a snapshot of the Inter-Departmental Business Register (IDBR) taken on 12 March 2021. This dataset contains "},{"id":"traffic-camera-activity","title":"Traffic Camera Activity","description":"Experimental dataset for business indices covering the UK as part of the real-time indicators release to help better understand economic activity and social change in the UK."},{"id":"trade","title":"Trade in goods: country by commodity","description":"Country by commodity data on the UK's trade in goods, including trade by all countries and selected commodities, exports and imports, non seasonally adjusted."},{"id":"tax-benefits-statistics","title":"Effects of Taxes and Benefits on Household Income","description":"Estimates of mean and median annual incomes in the UK, by quintile groups.\nThe redistribution effects on individuals of direct and indirect taxation and benefits received in cash or kind."},{"id":"suicides-in-the-uk","title":"Suicide registrations in England and Wales by local authority","description":"Number of suicides by local authority in England and Wales, registered from 2001.\n\nIf you are struggling to cope, please call Samaritans for free on 116 123 (UK and ROI) or contact other sources of su"},{"id":"sexual-orientation-by-region","title":"Sexual orientation by English regions and UK countries","description":"Sexual orientation in the UK from 2012 to 2020 by region.\n\nData source: Annual Population Survey, ONS\n"},{"id":"sexual-orientation-by-age-and-sex","title":"Sexual orientation by age and sex","description":"Sexual orientation in the UK by sex and age, 2014 to 2020.\n\nSource: Annual Population Survey, ONS"},{"id":"retail-sales-index-large-and-small-businesses","title":"Retail sales index - large and small businesses","description":"Value and volume of retail sales broken down by size of business"},{"id":"retail-sales-index-all-businesses","title":"Retail sales index - all businesses","description":"Value and volume of retail sales for all businesses."},{"id":"retail-sales-index","title":"Retail sales index","description":"Retail sales data for Great Britain in value and volume terms, seasonally and non-seasonally adjusted."},{"id":"regional-gdp-by-year","title":"Annual GDP for England, Wales and the English regions","description":"Annual economic activity within England, Wales and the nine English regions (North East, North West, Yorkshire and the Humber, East Midlands, West Midlands, East of England, Greater London, South East"},{"id":"regional-gdp-by-quarter","title":"Quarterly GDP for England, Wales and the English regions","description":"Quarterly economic activity within England, Wales and the nine English regions (North East, North West, Yorkshire and The Humber, East Midlands, West Midlands, East of England, London, South East, Sou"},{"id":"projections-older-people-sex-ratios","title":"Local authority ageing statistics, projected sex ratios for older people","description":"Projected indicators included are derived from the published 2018-based subnational population projections for England, Wales, Scotland and Northern Ireland up to the year 2043. The indicators are the"},{"id":"projections-older-people-in-single-households","title":"Local authority ageing statistics, household projections for older people","description":"Projected indicators included are derived from the published 2018-based household projections for England and 2018-based household projections for Scotland for the years 2018 up to 2043. The indicator"},{"id":"output-in-the-construction-industry","title":"Output in the construction industry","description":"Monthly construction output for Great Britain at current price and chained volume measures, seasonally adjusted by public and private sector."},{"id":"online-job-advert-estimates","title":"Faster Indicators - Online Job Advert Estimates","description":"Experimental job advert indices covering the UK job market."},{"id":"older-people-sex-ratios","title":"Local authority ageing statistics, sex ratios for people aged 65 and over and 85 and over","description":"Both indicators included have been derived from the published 2019 mid-year population estimates for the UK, England, Wales, Scotland and Northern Ireland. These are sex ratios for people aged 65 year"},{"id":"older-people-net-internal-migration","title":"Local authority ageing statistics, net internal migration people aged 65 and over and 85 and over","description":"Figures presented show the movement of older people between local authorities and regions. Both indicators included in this dataset have been derived from the published 2019 internal migration dataset"},{"id":"older-people-economic-activity","title":"Local authority ageing statistics, older people economic activity","description":"Indicators included are economic activity and employment rates for those aged 50-64 years, by country, region and local authority. Both economic activity and employment rates are displayed as percenta"},{"id":"mid-year-pop-est","title":"Population Estimates for UK, England and Wales, Scotland and Northern Ireland","description":"Estimates of the usual resident population for the UK as at 30 June of the reference year. Provided by administrative area, single year of age and sex."},{"id":"life-expectancy-by-local-authority","title":"Life Expectancy by Local Authority","description":"Subnational trends in the average number of years people will live beyond their current age measured by “period life expectancy”."},{"id":"labour-market","title":"UK Labour Market","description":"The LFS is a data source compiled from a survey of the UK population. It uses internationally recognised definitions of employment, unemployment and economic activity. It also captures other personal "},{"id":"index-private-housing-rental-prices","title":"Index of Private Housing Rental Prices","description":"An experimental price index tracking the prices paid for renting property from private landlords in the United Kingdom"},{"id":"house-prices-local-authority","title":"House price statistics for small areas in England and Wales","description":"Summary statistics for housing transactions by local authority in England and Wales, on an annual basis, updated quarterly using HM Land Registry Price Paid Data. Select values from the Year and Month"},{"id":"health-accounts","title":"Expenditure on healthcare: UK Health Accounts","description":"Healthcare expenditure statistics, produced to the international definitions of the System of Health Accounts 2011.\n\nSubcategories may not sum to aggregates due to rounding."},{"id":"gva-by-industry-by-local-authority","title":"GVA by industry by local authority","description":"Gross value added (balanced) in current basic prices and as chained volume measures, with a breakdown by 24 industry sectors, for each local authority district, metropolitan district, London borough a"},{"id":"generational-income","title":"Generational income: The effects of taxes and benefits","description":"The effects of direct and indirect taxation and benefits received in cash or kind on household income, across the generations and by age.\n\nThis data is estimated by combining multiple years of the Liv"},{"id":"gdp-to-four-decimal-places","title":"GDP monthly estimate (incorporating the Index of Services and Index of Production)","description":"Gross domestic product (GDP) measures the value of goods and services produced in the UK. It estimates the size of and growth in the economy. This dataset also contains the Index of Services (monthly "},{"id":"gdp-by-local-authority","title":"GDP by local authority","description":"Gross domestic product (GDP) in current market prices and as chained volume measures, plus GDP per capita, for each local authority district, metropolitan district, London borough and Scottish Council"},{"id":"faster-indicators-shipping-data","title":"Coronavirus and the latest indicators for the UK economy and society: Shipping indicators","description":"These shipping indicators are based on counts of all vessels, and cargo and tanker vessels. As discussed in Faster indicators of UK economic activity: shipping (please see the related links), we expec"},{"id":"cpih01","title":"Consumer Prices Index including owner occupiers' housing costs (CPIH)","description":"CPIH is the most comprehensive measure of inflation. It extends CPI to include a measure of the costs associated with owning, maintaining and living in one's own home, known as owner occupiers' housin"},{"id":"childrens-wellbeing","title":"Children's Well-being Measures","description":"How children aged 0 to 15 years in the UK are coping in a range of areas that matter to their quality of life, reflecting the circumstances of their lives and their own perspectives.\n\nThis is a subset"},{"id":"ashe-tables-9-and-10","title":"Earnings and hours worked, place of work and place of residence by Parliamentary constituency: ASHE Tables 9 and 10","description":"Annual estimates of paid hours worked and earnings for UK employees by sex, and full-time and part-time, by home and work-based Parliamentary constituency. Hourly and weekly estimates are provided for"},{"id":"ashe-tables-7-and-8","title":"Earnings and hours worked, place of work and residence by local authority: ASHE Tables 7 and 8 ","description":"Annual estimates of paid hours worked and earnings for UK employees by sex, and full-time and part-time, by work-based and residence-based region to local and unitary authority level. Hourly and weekl"},{"id":"ashe-tables-3","title":"Earnings and hours worked, region by occupation by two-digit SOC: ASHE Table 3","description":"Annual estimates of paid hours worked and earnings for UK employees by sex, and full-time and part-time, by region and two-digit Standard Occupational Classification 2010. Hourly and weekly estimates "},{"id":"ashe-tables-27-and-28","title":"Earnings and hours worked, place of work and place of residence by local enterprise partnerships: ASHE Tables 27 and 28","description":"Annual estimates of paid hours worked and earnings for UK employees by sex, and full-time and part-time, by work-based and home-based local enterprise partnerships. Hourly and weekly estimates are pro"},{"id":"ashe-tables-26","title":"Earnings and hours worked, care workers: ASHE Table 26","description":"Annual estimates of paid hours worked and earnings for UK employees by sex, and full-time and part-time, for care workers, home carers and senior care workers as defined in the Standard Occupational C"},{"id":"ashe-tables-25","title":"Earnings and hours worked, UK region by public and private sector: ASHE Table 25","description":"Annual estimates of paid hours worked and earnings for UK employees by sex, and full-time and part-time, by region, and public and private sector, and non-profit bodies and mutual associations. Hourly"},{"id":"ashe-tables-20","title":"Earnings and hours worked, age group by occupation by two-digit SOC: ASHE Table 20","description":"Annual estimates of paid hours worked and earnings for UK employees by sex, and full-time and part-time, by age group and two-digit Standard Occupational Classification 2010. Hourly and weekly estimat"},{"id":"ashe-tables-11-and-12","title":"Earnings and Hours Worked, Work and Residence-Based Travel to Work Area: ASHE Tables 11 and 12","description":"Annual estimates of paid hours worked and earnings for UK employees by sex, and full-time and part-time, by home-based and work-based travel to work area. Hourly and weekly estimates are provided for "},{"id":"ashe-table-5","title":"Earnings and Hours Worked, UK Region by Industry by Two-Digit SIC: ASHE Table 5","description":"Annual estimates of paid hours worked and earnings for UK employees by sex, and full-time and part-time, by region, and public and private sector, and non-profit bodies and mutual associations. Hourly"},{"id":"ageing-population-projections","title":"Local authority ageing statistics, population projections for older people","description":"Projected indicators included are derived from the published 2018-based subnational population projections for England, Wales, Scotland and Northern Ireland up to the year 2043. The indicators are the"},{"id":"ageing-population-estimates","title":"Local authority ageing statistics, based on annual mid-year population estimates","description":"Indicators included have been derived from the published 2019 mid-year population estimates for the UK, England, Wales, Scotland and Northern Ireland. These are the number of persons and percentage of"}],"total_count":337},"meta":{"timestamp":"2026-06-15T20:40:38.347Z","request_id":"decf09ae-ac65-48c9-9222-99566f78307b"},"status":"ok","message":"ONS datasets retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"API metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"UK Statistics (ONS) API","notes":"Live data from the ONS beta API; month-on-month and year-on-year computed from the CPIH index series. The datasets endpoint lists the full ONS catalogue.","source":"UK Office for National Statistics — beta CMD API (api.beta.ons.gov.uk)","country":"United Kingdom","endpoints":["/v1/cpi","/v1/cpi/series","/v1/cpi/divisions","/v1/datasets","/v1/meta"],"documentation":"https://uk-stats-api.oanor.dev","primary_indicator":"CPIH — Consumer Prices Index including owner occupiers' housing costs (dataset cpih01, monthly, 2015=100)"},"meta":{"timestamp":"2026-06-15T20:40:38.424Z","request_id":"bd2aa8ef-7955-4161-9835-c7daf6ff94cb"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":300,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1120,"monthly_call_quota":19500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2940,"monthly_call_quota":99000,"rps_limit":22,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6720,"monthly_call_quota":445000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/uk-stats-api"}