Street-level outcomes
Outcomes at street-level; either at a specific location, within a 1 mile radius of a single point, or within a custom area.
Note: Outcomes are not available for the Police Service of Northern Ireland.
Request parameters
Specific location ID
Parameter | Description |
---|---|
date | YYYY-MM |
location_id | Crimes and outcomes are mapped to specific locations on the map. Valid IDs are returned by other methods which return location information. |
Latitude/longitude
Parameter | Description |
---|---|
date | YYYY-MM |
lat | Latitude of the requested crime area |
lng | Longitude of the requested crime area |
Custom area
poly | The lat/lng pairs which define the boundary of the custom area |
date | Optional. (YYYY-MM) Limit results to a specific month. The latest month will be shown by default |
When querying for crime within a custom area, the following restrictions apply:
- The area must contain no more than 10,000 outcomes. Otherwise, the API will return a 503 status code.
The poly
parameter is formatted in lat/lng pairs, separated by colons:
[lat],[lng]:[lat],[lng]:[lat],[lng]
The first and last coordinates need not be the same - they will be joined by a straight line once the request is made.
Example request
Specific location ID
https://data.police.uk/api/outcomes-at-location?date=2017-01&location_id=883498
Latitude/longitude
https://data.police.uk/api/outcomes-at-location?date=2017-01&lat=52.629729&lng=-1.131592
Custom area
https://data.police.uk/api/outcomes-at-location?date=2017-01&poly=52.268,0.543:52.794,0.238:52.130,0.478
Example response
[
{
"category": {
"code": "unable-to-prosecute",
"name": "Unable to prosecute suspect"
},
"date": "2017-01",
"person_id": null,
"crime": {
"category": "theft-from-the-person",
"location_type": "Force",
"location": {
"latitude": "52.634474",
"street": {
"id": 883498,
"name": "On or near Kate Street"
},
"longitude": "-1.149197"
},
"context": "",
"persistent_id": "a5a98275facee535b959b236130f5ec05205869fb3d0804c9b14296fcd0bce46",
"id": 53566126,
"location_subtype": "ROAD",
"month": "2016-12"
}
}
]
Response description
Tag | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
category | Category of the outcome
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
code | Internal code | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name | Human-readable name | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
date | Date of the outcome | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
person_id | An identifier for the suspect/offender, where available. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
crime | Crime information | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
category | Category of the crime | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
location_type | The type of the location. Either Force or BTP: Force indicates a normal police force location; BTP indicates a British Transport Police location. BTP locations fall within normal police force boundaries. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
location_subtype | For BTP locations, the type of location at which this crime was recorded. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
persistent_id | 64-character unique identifier for that crime. (This is different to the existing 'id' attribute, which is not guaranteed to always stay the same for each crime.) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
month | Month of the crime | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
location | Approximate location of the incident | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
latitude | Latitude | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
street | The approximate street the crime occurred | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
id | Unique identifier for the street | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name | Name of the location. This is only an approximation of where the crime happened |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
longitude | Longitude | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
context | Extra information about the crime (if applicable) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
id | ID of the crime. This ID only relates to the API, it is NOT a police identifier |