Search UK Police Outcomes
ukcrime_search_outcomesRead-onlyIdempotent
List the police outcomes recorded in one month inside an area — a point with a 1-mile radius, a polygon, a location_id, or a neighbourhood — for crimes recorded that month or any earlier one. Returns the total, counts by outcome and by the month each crime was recorded, and a page of outcomes, each with its crime and persistent_id. Use it for what police resolved in a month; ukcrime_search_crimes gives the latest outcome of the crimes recorded in a month instead. Court results are not published; the result says when a force publishes no outcomes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude, WGS84 decimal degrees, for area 'point'. | |
| lng | No | Longitude, WGS84 decimal degrees, for area 'point'. | |
| area | Yes | Area to search: 'point' (lat and lng; a 1-mile radius), 'polygon' (polygon), 'location' (location_id), or 'neighbourhood' (force and neighbourhood_id). An area field the chosen area does not use is rejected. | |
| force | No | For area 'neighbourhood', with neighbourhood_id: a force id such as 'leicestershire', or its name such as 'Leicestershire Police' (ukcrime_list_reference topic 'forces' lists both); case-insensitive, spaces, underscores and hyphens match each other, '&' matches 'and', and a trailing 'Police', 'Police Service' or 'Constabulary' is optional. | |
| limit | No | Outcomes on this page, 1–200. Default 20. | |
| month | No | Month as YYYY-MM. Omitted: the latest published month, echoed as month in the result. | |
| offset | No | Rows to skip before this page; pass next_offset from the previous result. Default 0. | |
| polygon | No | For area 'polygon': 3–2,500 vertices as { lat, lng } objects, or the string 'lat,lng:lat,lng:…'. The ring closes itself (the last vertex joins the first). [lng, lat] pairs are not accepted. | |
| category | No | Count only outcomes for crimes in this category: a slug such as 'burglary' or a display name such as 'Violence and sexual offences'; case-insensitive, and spaces, underscores and hyphens match each other ('vehicle_crime' finds 'vehicle-crime'). Omitted or 'all-crime': every category. ukcrime_list_reference topic 'categories' lists them. | |
| location_id | No | For area 'location': location.location_id from an earlier result — one anonymised map point. | |
| neighbourhood_id | No | For area 'neighbourhood', with force: a neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', or from ukcrime_find_neighbourhood for a point. Case-sensitive; only trimmed. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Page limit applied. | |
| area | No | The area as the server searched it. | |
| error | No | Present when the call failed. Absent on success. | |
| month | No | The month searched — when the outcomes were recorded — YYYY-MM. | |
| shown | No | Rows on this page. | |
| total | No | Outcomes matched, after the category filter. | |
| notice | No | Defaulted month, coverage gaps, why a result is empty, and how to page on. | |
| category | No | The crime category counted; absent when every category was (no category, or 'all-crime'). | |
| outcomes | No | This page of matched outcomes, sorted by the crime's month, newest first, then crime id. | |
| data_note | No | What these records can and cannot say; read it first. | |
| truncated | No | True when more rows remain after this page. | |
| by_outcome | No | Matched outcomes by outcome, most first. | |
| attribution | No | Open Government Licence attribution. | |
| next_offset | No | Pass as offset for the next page; absent on the last page. | |
| by_crime_month | No | Matched outcomes by the month their crime was recorded, newest first. | |
| unfiltered_total | No | Outcomes recorded in the area and month before the category filter. |