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 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=2024-01&location_id=1737432

Latitude and longitude

https://data.police.uk/api/outcomes-at-location?date=2024-01&lat=52.629729&lng=-1.131592

Custom area

https://data.police.uk/api/outcomes-at-location?date=2024-01&poly=52.268,0.543:52.794,0.238:52.130,0.478

Example response

[
    {
        "category": {
            "code": "local-resolution", 
            "name": "Local resolution"
        }, 
        "date": "2024-01", 
        "person_id": null, 
        "crime": {
            "category": "public-order", 
            "persistent_id": "dd6e56f90d1bdd7bc7482af17852369f263203d9a688fac42ec53bf48485d8f1", 
            "location_subtype": "ROAD", 
            "location_type": "Force", 
            "location": {
                "latitude": "52.637146", 
                "street": {
                    "id": 1737432, 
                    "name": "On or near Vaughan Street"
                }, 
                "longitude": "-1.149381"
            }, 
            "context": "", 
            "month": "2024-01", 
            "id": 116202605
        }
    }, 
    {
        "category": {
            "code": "local-resolution", 
            "name": "Local resolution"
        }, 
        "date": "2024-01", 
        "person_id": null, 
        "crime": {
            "category": "violent-crime", 
            "persistent_id": "ce5162b1783d03618e872652aed144994477aca348d3bc138f2c68b252f1f741", 
            "location_subtype": "ROAD", 
            "location_type": "Force", 
            "location": {
                "latitude": "52.637146", 
                "street": {
                    "id": 1737432, 
                    "name": "On or near Vaughan Street"
                }, 
                "longitude": "-1.149381"
            }, 
            "context": "", 
            "month": "2024-01", 
            "id": 116202623
        }
    }, 
    ...
]

Response description

Tag Description
category Category of the outcome

Code Name
awaiting-court-result Awaiting court outcome
court-result-unavailable Court result unavailable
unable-to-proceed Court case unable to proceed
local-resolution Local resolution
no-further-action Investigation complete; no suspect identified
deprived-of-property Offender deprived of property
fined Offender fined
absolute-discharge Offender given absolute discharge
cautioned Offender given a caution
drugs-possession-warning Offender given a drugs possession warning
penalty-notice-issued Offender given a penalty notice
community-penalty Offender given community sentence
conditional-discharge Offender given conditional discharge
suspended-sentence Offender given suspended prison sentence
imprisoned Offender sent to prison
other-court-disposal Offender otherwise dealt with
compensation Offender ordered to pay compensation
sentenced-in-another-case Suspect charged as part of another case
charged Suspect charged
not-guilty Defendant found not guilty
sent-to-crown-court Defendant sent to Crown Court
unable-to-prosecute Unable to prosecute suspect
formal-action-not-in-public-interest Formal action is not in the public interest
action-taken-by-another-organisation Action to be taken by another organisation
further-investigation-not-in-public-interest Further investigation is not in the public interest
further-action-not-in-public-interest Further action is not in the public interest
under-investigation Under investigation
status-update-unavailable Status update unavailable
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