Added
- New /v1/census product for UK census demographics. Discover datasets with GET /v1/census/datasets and GET /v1/census/datasets/{datasetCode}, where
datasetCodeis a nation vintage such asew-2021orsco-2022. - Browse the structure of a dataset: GET /v1/census/datasets/{datasetCode}/variables and GET /v1/census/datasets/{datasetCode}/variables/{slug} for topics, GET /v1/census/datasets/{datasetCode}/classifications/{classificationCode} and GET /v1/census/datasets/{datasetCode}/categories/{categoryCode} for granularity cuts. GET /v1/census/catalog/{datasetCode} returns a flat list of every
categoryCodeand the geography levels it can be served at. - Build a multi-area profile with POST /v1/census/datasets/{datasetCode}/profile — pass up to 100
geographyCodes(optionally filtered by variable slug) to get each category value with its rawcountand proportion in [0,1]. - Aggregate a custom area with POST /v1/census/datasets/{datasetCode}/rollup — supply up to 100
geographyCodesand thecategoryCodesto roll up. Ratios are computed as SUM(count)/SUM(base), never an average of child ratios. - Map-ready outputs in ONS Census Maps flat-file format: GET /v1/census/tiles/{datasetCode}/{geotype}/{tile}/{categoryCode}.csv returns a slippy-tile choropleth as
geography_code,valueCSV, GET /v1/census/whole/{datasetCode}/{geotype}/{country}/{categoryCode}.csv returns a whole-country level, and GET /v1/census/breaks/{datasetCode}/{geotype}/{categoryCode}.json returns a 6-float ckmeans legend (5 colour classes). GET /v1/census/grid/{datasetCode} returns the XYZ quad grid for client tiling. - The tile, whole-country and breaks endpoints accept an optional
modequery parameter:standard(default) returns a proportion in [0,1],changereturns the signed percentage-point change between censuses. Geography levels includeoa,lsoa,msoa,lad,regionandcountry. - Property responses now carry a
_provenancemap onPropertyDatarecording per-field provenance for any field resolved from an asserted trusted-source claim (source, provider and trust horizon).
Changed
- The
prosperityobject returned by GET /v1/property/{locationIds} is substantially richer. It now includescomputedAt,dataQuality, anindicatorsarray of the underlying ONS/MHCLG measures, and an OAC geodemographicclassification(null for Scotland and Northern Ireland). - Each per-dimension score under
prosperity.dimensionsnow addspercentile,dataQuality,weightand a human-readablecalculationalongside the existingscore. All new fields are additive.
Affected endpoints
- GET /v1/census/datasets
- GET /v1/census/datasets/{datasetCode}
- GET /v1/census/datasets/{datasetCode}/variables
- GET /v1/census/datasets/{datasetCode}/variables/{slug}
- GET /v1/census/datasets/{datasetCode}/classifications/{classificationCode}
- GET /v1/census/datasets/{datasetCode}/categories/{categoryCode}
- GET /v1/census/catalog/{datasetCode}
- POST /v1/census/datasets/{datasetCode}/profile
- POST /v1/census/datasets/{datasetCode}/rollup
- GET /v1/census/tiles/{datasetCode}/{geotype}/{tile}/{categoryCode}
- GET /v1/census/whole/{datasetCode}/{geotype}/{country}/{categoryCode}
- GET /v1/census/breaks/{datasetCode}/{geotype}/{categoryCode}
- GET /v1/census/grid/{datasetCode}
- GET /v1/property/{locationIds}