Skip to main content

Endpoints

All endpoints require an X-API-Key header for authentication.

Endpoints are grouped below by category: Street Works, Location & Property, Transport, and Utilities & Infrastructure.

Street Works​

GET /usrn-history​

Permit history for a USRN, broken down by fiscal year.

Potential use cases:

  • Compare promoter activity across fiscal years to spot trends in works or traffic management types

Response fields:

fiscal_year — UK fiscal year (April to March)
permits — Total number of permits issued
distinct_promoters — Number of unique promoters
active_months — Months with active works
emergency — Emergency permit count
signals — Temporary traffic signals count
closures — Road closure count
collaborative — Collaborative works count
avg_duration_days — Average permit duration in days
total_days_of_works — Total days of works across all permits
top_5_promoters — Top 5 promoters by permit volume
top_5_emergency — Top 5 promoters by emergency permits
top_5_new_connections — Top 5 promoters by new connections
licensing — Open Government Licence v3.0 (Department for Transport)

{
  "usrn": "string",
  "fiscal_years": [
    {
      "fiscal_year": "FY 2024/25",
      "permits": 0,
      "distinct_promoters": 0,
      "active_months": 0,
      "emergency": 0,
      "signals": 0,
      "closures": 0,
      "collaborative": 0,
      "avg_duration_days": 0,
      "total_days_of_works": 0,
      "top_5_promoters": { "BT": 12, "ELECTRICITY NORTH WEST LIMITED": 5 },
      "top_5_emergency": { "BT": 3 },
      "top_5_new_connections": null
    }
  ],
  "licensing": "Contains Street Manager data © Department for Transport, licensed under the Open Government Licence v3.0."
}

Data source: OS Open USRNs from Ordnance Survey and Street Manager data from the Department for Transport, both available under the Open Government Licence v3.0.

GET /promoter-usrn-activity​

Aggregated street works activity for a specific promoter on a given USRN.

Query parameters:

  • usrn — Unique Street Reference Number (numeric)
  • promoter_swa_code — Promoter SWA code

Potential use cases:

  • Understand how active a specific utility company is on a given street

Response fields:

usrn — Unique Street Reference Number
street_name — Name of the street
highway_authority_swa_code — SWA code for the highway authority
highway_authority — Name of the highway authority
promoter_swa_code — SWA code of the promoter
promoter_organisation — Name of the promoter organisation
total_permits — Total completed permits
emergency_permits — Number of emergency permits
collaborative_permits — Number of collaborative permits
signals_permits — Permits involving temporary traffic signals
closures_permits — Permits involving road closures
avg_duration_days — Average permit duration in days
total_days_of_works — Total days of works across all permits
first_work_date — Date of the earliest completed permit
last_work_date — Date of the most recent completed permit
work_categories — Permit counts broken down by work category
activity_types — Permit counts broken down by activity type
licensing — Open Government Licence v3.0 (Department for Transport)

{
  "usrn": "string",
  "street_name": "string",
  "highway_authority_swa_code": "string",
  "highway_authority": "string",
  "promoter_swa_code": "string",
  "promoter_organisation": "string",
  "total_permits": 0,
  "emergency_permits": 0,
  "collaborative_permits": 0,
  "signals_permits": 0,
  "closures_permits": 0,
  "avg_duration_days": 0.0,
  "total_days_of_works": 0,
  "first_work_date": "2020-04-01",
  "last_work_date": "2024-11-15",
  "work_categories": { "Minor": 10, "Standard": 3 },
  "activity_types": { "New": 8, "Remedial": 5 },
  "licensing": "Contains Street Manager data © Department for Transport, licensed under the Open Government Licence v3.0."
}

Data source: OS Open USRNs from Ordnance Survey and Street Manager data from the Department for Transport, both available under the Open Government Licence v3.0.

GET /usrn-info​

Street information and all known promoters for a USRN.

Potential use cases:

  • Quickly identify which utility companies and authorities are active on a given street

Response fields:

usrn — Unique Street Reference Number
highway_authority_swa_code — SWA code for the highway authority
highway_authority — Name of the highway authority
street_name — Name of the street
promoters — List of all promoters that have worked on this street
licensing — Open Government Licence v3.0 (Department for Transport)

{
  "usrn": "string",
  "highway_authority_swa_code": "string",
  "highway_authority": "string",
  "street_name": "string",
  "promoters": [
    "BT",
    "ELECTRICITY NORTH WEST LIMITED (NORWEB)",
    "WIGAN METROPOLITAN BOROUGH COUNCIL"
  ],
  "licensing": "Contains Street Manager data © Department for Transport, licensed under the Open Government Licence v3.0."
}

Data source: OS Open USRNs from Ordnance Survey and Street Manager data from the Department for Transport, both available under the Open Government Licence v3.0.

GET /section-58​

Section 58 (New Roads and Street Works Act 1991) street works restriction history for a USRN: the currently active restriction (if any), its full in-force history, and any notices created but not yet in force.

Potential use cases:

  • Check whether a street currently has a Section 58 restriction in place before planning further works
  • Review the history of restrictions on a street to understand how often it has been protected from works
  • Identify upcoming restrictions that have been created but aren't yet in force

Response fields:

usrn — Unique Street Reference Number
street_name — Name of the street
highway_authority — Name of the highway authority
highway_authority_swa_code — SWA code for the highway authority
active_section_58 — Whether a Section 58 restriction is currently active
active_section_58_count — Number of currently active restrictions
active_section_58_reference_number — Reference number of the active restriction
active_street_name / active_area_name / active_town — Location details for the active restriction
active_section_58_coordinates — Coordinates of the active restriction
active_start_date / active_end_date — Start and end dates of the active restriction
active_section_58_duration — Duration of the active restriction
active_section_58_extent — Extent of the active restriction
active_section_58_location_type — Location type of the active restriction
active_status_change_date — Date the active restriction's status last changed
active_in_force_at — Timestamp the active restriction came into force
in_force_history_count — Number of restrictions that have been in force historically
in_force_history — Full history of in-force restrictions
past_in_force_count / past_in_force_section_58s — Past restrictions that are no longer active
created_section_58_count — Number of restrictions created but not yet in force
has_created_section_58 — Whether any restrictions have been created but aren't yet in force
created_section_58s — Restrictions created but not yet in force
licensing — Open Government Licence v3.0 (Department for Transport)

{
  "usrn": "string",
  "street_name": "string",
  "highway_authority": "string",
  "highway_authority_swa_code": "string",
  "active_section_58": true,
  "active_section_58_count": 1,
  "active_section_58_reference_number": "SEC58-2025-001",
  "active_street_name": "string",
  "active_area_name": "string",
  "active_town": "string",
  "active_section_58_coordinates": "string",
  "active_start_date": "2025-01-15",
  "active_end_date": "2028-01-15",
  "active_section_58_duration": "3 years",
  "active_section_58_extent": "Full width",
  "active_section_58_location_type": "Carriageway",
  "active_status_change_date": "2025-01-15",
  "active_in_force_at": "2025-01-15T00:00:00",
  "in_force_history_count": 2,
  "in_force_history": [],
  "past_in_force_count": 1,
  "past_in_force_section_58s": [],
  "created_section_58_count": 0,
  "has_created_section_58": false,
  "created_section_58s": [],
  "licensing": "Contains Street Manager data © Department for Transport, licensed under the Open Government Licence v3.0."
}

Data source: Street Manager data from the Department for Transport, available under the Open Government Licence v3.0.

Location & Property​

GET /usrn-postcode​

The postcode(s) that cover a given USRN, including a primary postcode and the full set of postcodes found along the street.

Potential use cases:

  • Enrich USRN-level data with postcode information for reporting or geocoding
  • Identify all postcodes that share a street, useful for streets that span multiple postcode areas

Response fields:

usrn — Unique Street Reference Number
primary_postcode — The most representative postcode for this USRN
postcode_count — Number of distinct postcodes found along this USRN
postcodes — Full list of postcodes covering this USRN
licensing — Ordnance Survey, Royal Mail, GeoPlace and ONS attribution (Open Government Licence v3.0)

{
  "usrn": "string",
  "primary_postcode": "M1 1AE",
  "postcode_count": 2,
  "postcodes": ["M1 1AE", "M1 1AF"],
  "licensing": "Contains OS data © Crown copyright and database right 2025 | Contains Royal Mail data © Royal Mail copyright and Database right 2025 | Contains GeoPlace data © Local Government Information House Limited copyright and database right 2025 | Contains Office for National Statistics data licensed under the Open Government Licence v.3.0"
}

Data source: Ordnance Survey, Royal Mail, GeoPlace and the Office for National Statistics, available under the Open Government Licence v3.0.

GET /uprns-per-usrn​

UPRN count for a USRN, derived from OS Linked Identifiers.

Potential use cases:

  • Assess community impact of works on streets with high property counts
  • Prioritise communications for permits affecting densely populated streets

Response fields:

usrn — Unique Street Reference Number
uprn_count — Number of Unique Property Reference Numbers linked to this USRN
licensing — Open Government Licence v3.0 (Ordnance Survey)

{
  "usrn": "string",
  "uprn_count": 142,
  "licensing": "Contains data from the Open USRN dataset and Open Linked Identifiers dataset, licensed under the Open Government Licence v3.0."
}

Data source: OS Linked Identifiers from Ordnance Survey, available under the Open Government Licence v3.0.

GET /retail-centre-usrns​

The retail centre(s) that a given USRN falls within, if any. Most USRNs are not part of a retail centre, in which case retail_centres returns as an empty list.

Potential use cases:

  • Identify streets located within a retail centre for footfall or commercial impact analysis
  • Cross-reference street works activity with retail centre boundaries

Response fields:

usrn — Unique Street Reference Number
street_type — The type of USRN
retail_centres — List of retail centres this USRN falls within
  rc_id — Retail centre identifier
  rc_name — Retail centre name
  classification — Retail centre classification
  country / region — Location of the retail centre
  h3_count — Number of H3 cells covering the retail centre
  retail_count — Number of retail units in the retail centre
  area_km2 — Area of the retail centre in square kilometres
licensing — Open Government Licence v3.0

{
  "usrn": "string",
  "street_type": "Designated Street Name",
  "retail_centres": [
    {
      "rc_id": "string",
      "rc_name": "Manchester City Centre",
      "classification": "Regional Centre",
      "country": "England",
      "region": "North West",
      "h3_count": 48,
      "retail_count": 320,
      "area_km2": 1.2
    }
  ],
  "licensing": "Made available via Geographic Data Service. Contains retail centre boundary data licensed under the Open Government Licence v3.0."
}

Data source: Retail centre boundary data made available via the Geographic Data Service, licensed under the Open Government Licence v3.0.

GET /usrn-soil-attribution​

Soil attribution data from the National Soil Dataset matched to a USRN.

Potential use cases:

  • Understand ground conditions on a street before planning works
  • Draw possible relationships between asset health and reinstatements

Response fields:

usrn — Unique Street Reference Number
geology — Distinct geology classifications intersecting this USRN
soilscape — Distinct soilscape types intersecting this USRN
drainage — Distinct drainage classes intersecting this USRN
drains_to — Distinct drainage destinations intersecting this USRN
licensing — LandIS Open Licence (Cranfield University)

{
  "usrn": "string",
  "geology": ["Loamy and sandy soils with naturally high groundwater"],
  "soilscape": ["Freely draining slightly acid loamy soils"],
  "drainage": ["Well drained"],
  "drains_to": ["River"],
  "licensing": "LandIS Open Licence - Cranfield University"
}

Data source: National Soil Dataset from Cranfield University's LandIS Portal, available under the LandIS Open Licence.

Transport​

GET /usrn-naptan​

NaPTAN bus stop data matched to a USRN.

Potential use cases:

  • Identify whether a street has nearby bus stops before planning works
  • Assess public transport impact of permits on a given street

Response fields:

usrn — Unique Street Reference Number
street_type — Whether the USRN is a regular road or motorway
atco_codes — List of ATCO codes for matched bus stops
naptan_codes — List of NaPTAN codes for matched bus stops
stop_count — Total number of bus stops matched to this USRN
licensing — Open Government Licence v3.0 (Department for Transport)

{
  "usrn": "string",
  "street_type": "Regular Road",
  "atco_codes": ["010A0001", "010A0002"],
  "naptan_codes": ["0500SW", "0500SX"],
  "stop_count": 2,
  "licensing": "Contains NaPTAN data © Department for Transport, licensed under the Open Government Licence v3.0."
}

Data source: National Public Transport Access Nodes (NaPTAN), published by the Department for Transport. Bus stops are matched to USRNs within a 10m buffer.

GET /usrn-bods​

Active bus services and stops on a USRN, derived from the Bus Open Data Service (BODS).

Potential use cases:

  • Identify which registered bus services could be disrupted by street works on a given street
  • Cross-reference permit data with bus route coverage to assess transport impact
  • Map which agencies operate services along a specific USRN

Response fields:

usrn — Unique Street Reference Number
street_type — The type of USRN (e.g. "Officially Described Street")
stop_count — Total number of active bus stops on this USRN
naptan_codes — List of NaPTAN codes for stops on this USRN
atco_codes — List of ATCO codes for stops on this USRN
route_ids — Internal BODS route IDs for services on this USRN
route_short_names — Short names of bus routes (e.g. "42", "X10")
agency_names — Names of operating agencies
agency_nocs — National Operator Codes (NOCs) for each agency
active_route_count — Number of distinct active routes on this USRN
licensing — Open Government Licence v3.0 (Department for Transport)

{
  "usrn": "string",
  "street_type": "Designated Street Name",
  "stop_count": 4,
  "naptan_codes": ["0500SW001", "0500SW002"],
  "atco_codes": ["010A0001", "010A0002"],
  "route_ids": [1012, 1087],
  "route_short_names": ["42", "X10"],
  "agency_names": ["Arriva North West"],
  "agency_nocs": ["ANWE"],
  "active_route_count": 2,
  "licensing": "Contains BODS data © Department for Transport, licensed under the Open Government Licence v3.0. https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/ | Contains OS data © Crown copyright and database right 2025, licensed under the Open Government Licence v3.0. https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"
}

Data source: Bus Open Data Service (BODS), published by the Department for Transport. Bus services are matched to USRNs via NaPTAN stop locations.

Utilities & Infrastructure​

GET /usrn-underground-assets​

Cadent and Northern Gas gas pipe assets matched to a USRN, grouped into four phases in descending order of match confidence:

  • phase1 — overlaps the street geometry, up to 161m away
  • phase2 — overlaps the street geometry, within 10m
  • phase3 — no overlap, within 15m of the street
  • phase4 — no overlap, 13m or further from the street

Query parameters:

  • usrn — Unique Street Reference Number (numeric)
  • include_assets — Whether to include the full asset lists (true/false, default true). When false, the phase*_assets fields are omitted from the response entirely and only the counts are returned.

Potential use cases:

  • Understand what gas infrastructure sits under or near a street before planning works
  • Assess third-party asset risk and coordinate with Cadent/Northern Gas Networks
  • Use include_assets=false for a lightweight summary when only counts are needed

Response fields:

usrn — Unique Street Reference Number
street_type — The type of USRN (e.g. "Designated Street Name")
phase1_assets / phase2_assets / phase3_assets / phase4_assets — Gas pipe assets in each confidence phase (omitted when include_assets=false), each with:
  asset_id — Asset identifier
  network — Owning network (cadent or northern_gas)
  type — Asset type (e.g. "Main Pipe", "Service Pipe")
  pressure — Pressure tier (e.g. "LP", "MP")
  material — Pipe material (e.g. "PE")
  diameter / diam_unit — Pipe diameter and its unit
  distance_m — Distance from the street geometry in metres
  overlap_length_pct — Proportion of the asset overlapping the street (0–1)
phase1_count / phase2_count / phase3_count / phase4_count — Asset counts per phase
cadent_count / northern_gas_count — Asset counts by network
total_count — Total matched assets across all phases
licensing — Open Government Licence v3.0 (Cadent) and CC BY 4.0 (Northern Gas Networks)

{
  "usrn": "string",
  "street_type": "Designated Street Name",
  "phase1_assets": [
    {
      "asset_id": "string",
      "network": "cadent",
      "type": "Main Pipe",
      "pressure": "LP",
      "material": "PE",
      "diameter": 90.0,
      "diam_unit": "MM",
      "distance_m": 0.5,
      "overlap_length_pct": 0.8
    }
  ],
  "phase2_assets": [],
  "phase3_assets": [],
  "phase4_assets": [],
  "phase1_count": 1,
  "phase2_count": 0,
  "phase3_count": 0,
  "phase4_count": 0,
  "cadent_count": 1,
  "northern_gas_count": 0,
  "total_count": 1,
  "licensing": "Gas Pipe Infrastructure (GPI Open) © Cadent Gas Limited, available under the Open Government Licence v3.0. | Northern Gas Networks, Gas Pipe Infrastructure, licensed under CC BY 4.0 and subject to the Open Data Portal terms."
}

Data source: Cadent Gas Limited's Gas Pipe Infrastructure (GPI Open) dataset, available under the Open Government Licence v3.0, and Northern Gas Networks' open data portal, licensed under CC BY 4.0.

GET /usrn-broadband​

Gigabit/BDUK broadband coverage stats for a given USRN, along with a summary of telecoms street-works activity recorded against it.

Potential use cases:

  • Assess broadband coverage and subsidy status on a street before planning telecoms works
  • Cross-reference broadband rollout with historical telecoms street works activity

Response fields:

usrn — Unique Street Reference Number
premises — Number of premises covered
pct_current_gigabit — Percentage of premises with current gigabit coverage
pct_future_gigabit — Percentage of premises with planned future gigabit coverage
has_bduk_gis — Whether BDUK gigabit infrastructure subsidy applies
has_bduk_vouchers — Whether BDUK voucher scheme funding applies
has_bduk_superfast — Whether BDUK superfast programme funding applies
has_bduk_hubs — Whether BDUK public hub funding applies
dominant_subsidy_status — The dominant BDUK subsidy status for this USRN
gis_suppliers — Gigabit infrastructure suppliers active on this USRN
telco_works_permits — Number of telecoms street works permits recorded
distinct_telco_promoters — Number of distinct telecoms promoters
telco_promoters — Telecoms promoters that have worked on this street
telco_promoter_permits — Permit counts per telecoms promoter
telco_first_work_date / telco_last_work_date — Date range of telecoms works
telco_total_days_of_works — Total days of telecoms works
has_telco_works — Whether any telecoms works have been recorded
licensing — Open Government Licence v3.0 (BDUK / Street Manager)

{
  "usrn": "string",
  "premises": 120,
  "pct_current_gigabit": 85.5,
  "pct_future_gigabit": 100.0,
  "has_bduk_gis": true,
  "has_bduk_vouchers": false,
  "has_bduk_superfast": false,
  "has_bduk_hubs": false,
  "dominant_subsidy_status": "Gigabit Infrastructure Subsidy",
  "gis_suppliers": ["Openreach"],
  "telco_works_permits": 4,
  "distinct_telco_promoters": 2,
  "telco_promoters": "BT, Virgin Media",
  "telco_promoter_permits": "BT: 3, Virgin Media: 1",
  "telco_first_work_date": "2021-06-01",
  "telco_last_work_date": "2024-09-12",
  "telco_total_days_of_works": 21,
  "has_telco_works": true,
  "licensing": "Contains BDUK broadband coverage data and Street Manager street works data, licensed under the Open Government Licence v3.0."
}

Data source: BDUK broadband coverage data and Street Manager street works data from the Department for Transport, both available under the Open Government Licence v3.0.