Bulk Address Intelligence

Process multiple addresses in a single request to retrieve risk intelligence data.

POST /api/address/bulk?code={your_access_code}

Request Body

{
  "addresses": [
    {
      "search_type": "uprn",
      "query": "10023456789",
      "country": "gb"
    },
    {
      "search_type": "address",
      "query": "10 Downing Street, London",
      "country": "gb"
    }
  ],
  "provider": "STAC"
}

Parameters

Parameter	Description	Required	Default
addresses	Array of address objects	Yes	N/A
provider	Data provider to use for all addresses	No	STAC

Each address object should contain:

Parameter	Description	Required	Default
search_type	Either uprn or address	Yes	N/A
query	UPRN or address string	Yes	N/A
country	ISO country code	No	gb
provider	Override provider for this address	No	Parent provider value

Example Response

{
  "status": 200,
  "items": [
    {
      "identifier": "10023456789",
      "risk_factors": {
        "flood": {
          "overall": {
            "score": 25.5,
            "class": "low",
            "label": "Low Risk"
          },
          "river": {
            "score": 15.2,
            "class": "low"
          },
          "surface": {
            "score": 30.8,
            "class": "medium"
          },
          "coastal": {
            "score": 5.0,
            "class": "very_low"
          },
          "ea_rating": "Low"
        },
        "crime": {
          "burglary": {
            "score": 42.3,
            "class": "medium"
          },
          "criminal_damage": {
            "score": 38.7,
            "class": "medium"
          }
        },
        "natural_hazards": {
          "subsidence": {
            "score": 56.2,
            "class": "high"
          },
          "windstorm": {
            "value": 28.9
          }
        },
        "emergency_services": {
          "fire_station": {
            "drive_time": 8.5,
            "remoteness": {
              "score": 35.6,
              "class": "medium"
            }
          }
        }
      },
      "metadata": {
        "location_type": "residential"
      }
    },
    {
      "identifier": "10 Downing Street, London",
      "risk_factors": {
        // Risk factors for second address
      },
      "metadata": {
        "location_type": "commercial"
      }
    }
  ],
  "errors": null,
  "metadata": {
    "total_requested": 2,
    "successful": 2,
    "failed": 0
  }
}