Added
- GET /v1/connectivity/by-area/{codes} returns the fixed broadband shares held for up to 100 area codes in one request. Ofcom's own figures cover output areas, local authorities, Westminster constituencies and devolved constituencies. For lower and middle layer super output areas, Scottish data zones and intermediate zones and Northern Ireland super data zones, each share is derived by summing Ofcom's output-area counts. Each area's figure sets are under
fixed.figures, and every set says which it is inderivationand carriespremiseSet,buildIdand aprovenanceblock with the edition, data period, licence and attribution. - Each share in
sharesis a fraction between 0 and 1, with the publisher's column name inlabeland the speed range indirection,rangeFromMbps,rangeBelowMbpsandpolarity. A cell the publisher left blank is null, never 0. Requested codes that have no figures are listed inmissing, and the request returns 404 only when none of the requested codes has figures. - GET /v1/connectivity/by-postcode/{postcode} returns Ofcom's statements for one unit postcode, for all premises and for residential premises, in the same
fixedblock as GET /v1/connectivity/by-property/{locationId}. These are the postcode's figures, not a statement about any property in it. A postcode with no figures returns 404 with the error codepostcode_not_found.
Deprecated
- GET /v1/area-reference/connectivity/{geographicCodes} and metric ids
101,102and103on GET /v1/area-reference/metric-values are deprecated and keep working for now. Use GET /v1/connectivity/by-area/{codes} for an area, GET /v1/connectivity/by-postcode/{postcode} for a postcode and GET /v1/connectivity/by-property/{locationId} for a property. Those give fixed broadband figures as their sources state them: there is no 0 to 100 score and no mobile figure.
Removed
- Removed
areaMetrics.connectivityScorefrom theareaMetricsblock of site responses, and from the fields accepted by POST /v1/sites/query (query conditions andsort) and POST /v1/sites/aggregate. The field held no value in any response, so no result changes. A request that still names it returns 400: delete that condition, sort entry or aggregation. For an area's fixed broadband figures, use GET /v1/connectivity/by-area/{codes}.
Affected endpoints
- GET/v1/connectivity/by-area/{codes}
- GET/v1/connectivity/by-postcode/{postcode}
- GET/v1/area-reference/connectivity/{geographicCodes}
- GET/v1/area-reference/metric-values
- GET/v1/sites/{siteId}
- POST/v1/sites/query
- POST/v1/sites/aggregate
- POST/v1/sites/by-ids
- GET/v1/sites/by-property/{locationId}
- GET/v1/sites/by-point