UK Pothole API

How to Use the UK Pothole API

Once you register and get your API key from your dashboard, you can access pothole data using the endpoint:

GET https://api.ukpothole.co.uk/potholes.php?apikey=YOUR_KEY

Optional Query Parameters:

• city – Filter by city (e.g., London)
• town – Filter by specific town/area
• lat + lng + radius – Get potholes within a radius (km) of a coordinate
• page + per_page – Pagination (default 1 and 50)

Example Requests:

// Get all potholes in London
https://api.ukpothole.co.uk/potholes.php?apikey=YOUR_KEY&city=London

// Get potholes in a town
https://api.ukpothole.co.uk/potholes.php?apikey=YOUR_KEY&town=Southend

// Get potholes within 5km of a coordinate
https://api.ukpothole.co.uk/potholes.php?apikey=YOUR_KEY&lat=51.5&lng=0.7&radius=5

// Pagination
https://api.ukpothole.co.uk/potholes.php?apikey=YOUR_KEY&page=2&per_page=50

Response Format:

The API returns JSON with an array of potholes:

{
  "potholes": [
    {
      "id": 123,
      "description": "Large pothole on High Street",
      "street": "High Street",
      "town": "Southend",
      "city": "Southend-on-Sea",
      "latitude": 51.5432,
      "longitude": 0.7032,
      "reported_count": 2,
      "status": "pending"
    },
    ...
  ]
}

Tips for Using the API:

• Always include your apikey parameter.
• Combine lat/lng/radius with city or town to narrow results.
• Pagination helps when retrieving large datasets.
• Data is user-submitted; potholes may not be officially reported.