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	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