Search UK street crime, outcomes, stop and search, and neighbourhood teams (Scotland: BTP only).
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Find the police force and neighbourhood policing team for a point, or look one up by force and neighbourhood id. Returns the team's description, contact channels and police stations, its current priorities with the action taken, team members' ranks and names, and upcoming engagement events. include adds the boundary polygon, needed only to split a neighbourhood too large to search into smaller polygons: ukcrime_search_crimes, ukcrime_search_outcomes and ukcrime_search_stops take the neighbourhood directly through area 'neighbourhood'.
Latitude, WGS84 decimal degrees, to look up by point (with lng).
Longitude, WGS84 decimal degrees, to look up by point (with lat).
Force id such as 'leicestershire', or its name such as 'Leicestershire Police' (ukcrime_list_reference topic 'forces' lists both), to look up by id (with neighbourhood_id); case-insensitive, spaces, underscores and hyphens match each other, '&' matches 'and', and a trailing 'Police', 'Police Service' or 'Constabulary' is optional.
Optional sections to load: 'priorities', 'team', 'events', 'boundary'. Omitted: priorities, team and events. [] loads none of them.
Neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', to look up by id (with force). Exact spelling first; after a miss, a unique case-insensitive catalog match is retried.
Find the police force and neighbourhood policing team for a point, or look one up by force and neighbourhood id. Returns the team's description, contact channels and police stations, its current priorities with the action taken, team members' ranks and names, and upcoming engagement events. include adds the boundary polygon, needed only to split a neighbourhood too large to search into smaller polygons: ukcrime_search_crimes, ukcrime_search_outcomes and ukcrime_search_stops take the neighbourhood directly through area 'neighbourhood'.
| Argument | Type | Description |
|---|---|---|
| lat | number | Latitude, WGS84 decimal degrees, to look up by point (with lng). |
| lng | number | Longitude, WGS84 decimal degrees, to look up by point (with lat). |
| force | string | Force id such as 'leicestershire', or its name such as 'Leicestershire Police' (ukcrime_list_reference topic 'forces' lists both), to look up by id (with neighbourhood_id); case-insensitive, spaces, underscores and hyphens match each other, '&' matches 'and', and a trailing 'Police', 'Police Service' or 'Constabulary' is optional. |
| include | array | Optional sections to load: 'priorities', 'team', 'events', 'boundary'. Omitted: priorities, team and events. [] loads none of them. |
| neighbourhood_id | string | Neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', to look up by id (with force). Exact spelling first; after a miss, a unique case-insensitive catalog match is retried. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, WGS84 decimal degrees, to look up by point (with lng)."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, WGS84 decimal degrees, to look up by point (with lat)."
},
"force": {
"type": "string",
"pattern": "^\\s*[A-Za-z](?:[A-Za-z\\s&_-]*[A-Za-z])?\\s*$",
"maxLength": 100,
"description": "Force id such as 'leicestershire', or its name such as 'Leicestershire Police' (ukcrime_list_reference topic 'forces' lists both), to look up by id (with neighbourhood_id); case-insensitive, spaces, underscores and hyphens match each other, '&' matches 'and', and a trailing 'Police', 'Police Service' or 'Constabulary' is optional."
},
"include": {
"type": "array",
"items": {
"enum": [
"priorities",
"team",
"events",
"boundary"
],
"type": "string",
"description": "An optional section to load."
},
"maxItems": 4,
"description": "Optional sections to load: 'priorities', 'team', 'events', 'boundary'. Omitted: priorities, team and events. [] loads none of them."
},
"neighbourhood_id": {
"type": "string",
"pattern": "^[^/\\\\?#]+$",
"maxLength": 100,
"description": "Neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', to look up by id (with force). Exact spelling first; after a miss, a unique case-insensitive catalog match is retried."
}
},
"additionalProperties": false
}Fetch the full police outcome history of up to 25 crimes per call by persistent_id — the 64-character id on crimes from ukcrime_search_crimes and ukcrime_search_outcomes. Accepts up to 1,000 raw elements or nonblank delimited tokens and 128,000 aggregate UTF-16 code units; remaining_ids carries unprocessed unique ids for the next call. Returns each crime with every outcome, oldest first, and lists the ids data.police.uk does not hold. Anti-social behaviour records carry no persistent id.
| Argument | Type | Description |
|---|---|---|
| persistent_ids* | any | Persistent ids from ukcrime_search_crimes or ukcrime_search_outcomes: at most 1,000 raw array elements, 1,000 nonblank comma/whitespace-separated tokens before deduplication, and 128,000 aggregate UTF-16 code units. Ids are lower-cased, blanks and repeats dropped; every id is validated, the first 25 unique ids processed and the rest returned as remaining_ids. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"persistent_ids"
],
"properties": {
"persistent_ids": {
"anyOf": [
{
"type": "string",
"maxLength": 128000,
"description": "Comma- or whitespace-separated persistent ids, at most 1,000 nonblank tokens."
},
{
"type": "array",
"items": {
"type": "string",
"description": "One or more comma/whitespace-separated persistent ids."
},
"maxItems": 1000,
"description": "At most 1,000 raw elements and 128,000 aggregate UTF-16 code units."
}
],
"description": "Persistent ids from ukcrime_search_crimes or ukcrime_search_outcomes: at most 1,000 raw array elements, 1,000 nonblank comma/whitespace-separated tokens before deduplication, and 128,000 aggregate UTF-16 code units. Ids are lower-cased, blanks and repeats dropped; every id is validated, the first 25 unique ids processed and the rest returned as remaining_ids."
}
},
"additionalProperties": false
}Decode the vocabulary the other ukcrime tools take: police force ids, crime category slugs, a force's neighbourhood ids, and data availability — the published months, and which forces published stop and search in each. Use it when a force, category, neighbourhood id or month is unknown; name_contains filters forces and neighbourhoods by name. The Metropolitan Police has about 680 neighbourhoods, so filter by name there; to get the force and neighbourhood covering a latitude and longitude, call ukcrime_find_neighbourhood instead.
| Argument | Type | Description |
|---|---|---|
| force | string | Force id such as 'leicestershire', or its name such as 'Leicestershire Police'; case-insensitive, spaces, underscores and hyphens match each other, '&' matches 'and', and a trailing 'Police', 'Police Service' or 'Constabulary' is optional. Required for topic 'neighbourhoods'. On 'availability', where 'btp' (British Transport Police) is also accepted, adds the months this force did and did not publish stop and search. Not accepted on 'forces' or 'categories'. |
| month | string | Month as YYYY-MM. Topic 'availability' only: return just that month's row. |
| topic* | string | What to list: 'forces' (force ids), 'categories' (crime category slugs), 'availability' (published months and stop-and-search publication), or 'neighbourhoods' (one force's neighbourhood ids; needs force). |
| name_contains | string | Words that must all appear in the name, in any order — case, accents and punctuation ignored, so the value needs at least one letter or digit. Topics 'forces' and 'neighbourhoods' only. |
Search street-level crimes recorded in one month, or with month_from a range of up to 12 months, inside an area — a point with a 1-mile radius, a polygon, a snapped location_id from an earlier result, or a police neighbourhood — or list the crimes a force could not place on the map (area 'force_unplaced'). Returns the total, counts by category and by latest police outcome, the busiest map points, each month's total for a range, and a page of crimes, each with the persistent_id that ukcrime_get_crime_outcomes takes; for what police resolved in a month, whenever the crime was recorded, use ukcrime_search_outcomes. Locations are anonymised map points, not crime sites. data.police.uk can refuse an area holding more than about 10,000 crimes, whatever the category — then search smaller polygons.
| Argument | Type | Description |
|---|---|---|
| lat | number | Latitude, WGS84 decimal degrees, for area 'point'. |
| lng | number | Longitude, WGS84 decimal degrees, for area 'point'. |
| area* | string | Area to search: 'point' (lat and lng; a 1-mile radius), 'polygon' (polygon), 'location' (location_id), 'neighbourhood' (force and neighbourhood_id), or 'force_unplaced' (force alone: the crimes that force could not place on the map). An area field the chosen area does not use is rejected. |
| force | string | 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. For area 'neighbourhood' (with neighbourhood_id) and 'force_unplaced' (alone), where 'btp' (British Transport Police) is also accepted. |
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 crime category, outcome and 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.
| Argument | Type | Description |
|---|---|---|
| lat | number | Latitude, WGS84 decimal degrees, for area 'point'. |
| lng | number | Longitude, WGS84 decimal degrees, for area 'point'. |
| area* | string | 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 | string | 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 | integer | Requested outcomes on this page, 1–10,000; applied cap is at most 200. Default 20. |
Search police stop and search records for one month, or with month_from a range of up to 12 months, inside an area — a point with a 1-mile radius, a polygon, a location_id from an earlier result, or a police neighbourhood — or across a whole force with area 'force', which includes stops the force could not place. Returns the total and counts by search type, self-defined and officer-defined ethnicity, outcome, object of search, legislation, age range, gender, whether the outcome was linked to the object of search, and whether more than outer clothing was removed, each month's total for a range, and a page of stops. filters narrow the counts and the page together, so filtering one field and reading another's breakdown gives a cross-tab. Forces skip months and some publish none; the result names each force it finds for the area that did not publish, with the months it skipped.
| Argument | Type | Description |
|---|---|---|
| lat | number | Latitude, WGS84 decimal degrees, for area 'point'. |
| lng | number | Longitude, WGS84 decimal degrees, for area 'point'. |
| area* | string | Area to search: 'point' (lat and lng; a 1-mile radius), 'polygon' (polygon), 'location' (location_id), 'neighbourhood' (force and neighbourhood_id), or 'force' (force alone: every stop the force published for the month or range, placed or not). An area field the chosen area does not use is rejected. |
| force | string | 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. For area 'neighbourhood' (with neighbourhood_id) and 'force' (alone), where 'btp' (British Transport Police) is also accepted. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topic"
],
"properties": {
"force": {
"type": "string",
"pattern": "^\\s*[A-Za-z](?:[A-Za-z\\s&_-]*[A-Za-z])?\\s*$",
"maxLength": 100,
"description": "Force id such as 'leicestershire', or its name such as 'Leicestershire Police'; case-insensitive, spaces, underscores and hyphens match each other, '&' matches 'and', and a trailing 'Police', 'Police Service' or 'Constabulary' is optional. Required for topic 'neighbourhoods'. On 'availability', where 'btp' (British Transport Police) is also accepted, adds the months this force did and did not publish stop and search. Not accepted on 'forces' or 'categories'."
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "Month as YYYY-MM. Topic 'availability' only: return just that month's row."
},
"topic": {
"enum": [
"forces",
"categories",
"availability",
"neighbourhoods"
],
"type": "string",
"description": "What to list: 'forces' (force ids), 'categories' (crime category slugs), 'availability' (published months and stop-and-search publication), or 'neighbourhoods' (one force's neighbourhood ids; needs force)."
},
"name_contains": {
"type": "string",
"maxLength": 100,
"description": "Words that must all appear in the name, in any order — case, accents and punctuation ignored, so the value needs at least one letter or digit. Topics 'forces' and 'neighbourhoods' only."
}
},
"additionalProperties": false
}| limit | integer | Requested crimes on this page, 1–10,000; applied cap is at most 200. Default 25. |
| month | string | Month as YYYY-MM, or the last month of the range with month_from. Omitted: the latest published month, echoed as month in the result. |
| offset | integer | Rows to skip before this page; pass next_offset from the previous result. Default 0. |
| polygon | array | 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 | string | Crime category slug such as 'burglary', or its display name such as 'Violence and sexual offences'; case-insensitive, and spaces, underscores and hyphens match each other ('vehicle_crime' finds 'vehicle-crime'). Omitted: every category (all-crime). ukcrime_list_reference topic 'categories' lists them. |
| month_from | string | First month of a range, YYYY-MM, searched through month — up to 12 months, with a total for each in by_month. Omitted: month alone. |
| location_id | string | For area 'location': location.location_id from an earlier result — one anonymised map point. |
| neighbourhood_id | string | For area 'neighbourhood', with force: a neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', or from ukcrime_find_neighbourhood for a point. Exact spelling first; after a miss, a unique case-insensitive catalog match is retried. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"area"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, WGS84 decimal degrees, for area 'point'."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, WGS84 decimal degrees, for area 'point'."
},
"area": {
"enum": [
"point",
"polygon",
"location",
"neighbourhood",
"force_unplaced"
],
"type": "string",
"description": "Area to search: 'point' (lat and lng; a 1-mile radius), 'polygon' (polygon), 'location' (location_id), 'neighbourhood' (force and neighbourhood_id), or 'force_unplaced' (force alone: the crimes that force could not place on the map). An area field the chosen area does not use is rejected."
},
"force": {
"type": "string",
"pattern": "^\\s*[A-Za-z](?:[A-Za-z\\s&_-]*[A-Za-z])?\\s*$",
"maxLength": 100,
"description": "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. For area 'neighbourhood' (with neighbourhood_id) and 'force_unplaced' (alone), where 'btp' (British Transport Police) is also accepted."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 10000,
"minimum": 1,
"description": "Requested crimes on this page, 1–10,000; applied cap is at most 200. Default 25."
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "Month as YYYY-MM, or the last month of the range with month_from. Omitted: the latest published month, echoed as month in the result."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows to skip before this page; pass next_offset from the previous result. Default 0."
},
"polygon": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, WGS84 decimal degrees."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, WGS84 decimal degrees."
}
},
"description": "One polygon vertex as { lat, lng }."
},
"maxItems": 2500,
"minItems": 3,
"description": "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": {
"type": "string",
"maxLength": 100,
"description": "Crime category slug such as 'burglary', or its display name such as 'Violence and sexual offences'; case-insensitive, and spaces, underscores and hyphens match each other ('vehicle_crime' finds 'vehicle-crime'). Omitted: every category (all-crime). ukcrime_list_reference topic 'categories' lists them."
},
"month_from": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "First month of a range, YYYY-MM, searched through month — up to 12 months, with a total for each in by_month. Omitted: month alone."
},
"location_id": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "For area 'location': location.location_id from an earlier result — one anonymised map point."
},
"neighbourhood_id": {
"type": "string",
"pattern": "^[^/\\\\?#]+$",
"maxLength": 100,
"description": "For area 'neighbourhood', with force: a neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', or from ukcrime_find_neighbourhood for a point. Exact spelling first; after a miss, a unique case-insensitive catalog match is retried."
}
},
"additionalProperties": false
}| month | string | Month as YYYY-MM. Omitted: the latest published month, echoed as month in the result. |
| offset | integer | Rows to skip before this page; pass next_offset from the previous result. Default 0. |
| polygon | array | 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 | string | 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 | string | For area 'location': location.location_id from an earlier result — one anonymised map point. |
| neighbourhood_id | string | For area 'neighbourhood', with force: a neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', or from ukcrime_find_neighbourhood for a point. Exact spelling first; after a miss, a unique case-insensitive catalog match is retried. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"area"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, WGS84 decimal degrees, for area 'point'."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, WGS84 decimal degrees, for area 'point'."
},
"area": {
"enum": [
"point",
"polygon",
"location",
"neighbourhood"
],
"type": "string",
"description": "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": {
"type": "string",
"pattern": "^\\s*[A-Za-z](?:[A-Za-z\\s&_-]*[A-Za-z])?\\s*$",
"maxLength": 100,
"description": "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": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Requested outcomes on this page, 1–10,000; applied cap is at most 200. Default 20."
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "Month as YYYY-MM. Omitted: the latest published month, echoed as month in the result."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows to skip before this page; pass next_offset from the previous result. Default 0."
},
"polygon": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, WGS84 decimal degrees."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, WGS84 decimal degrees."
}
},
"description": "One polygon vertex as { lat, lng }."
},
"maxItems": 2500,
"minItems": 3,
"description": "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": {
"type": "string",
"maxLength": 100,
"description": "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": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "For area 'location': location.location_id from an earlier result — one anonymised map point."
},
"neighbourhood_id": {
"type": "string",
"pattern": "^[^/\\\\?#]+$",
"maxLength": 100,
"description": "For area 'neighbourhood', with force: a neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', or from ukcrime_find_neighbourhood for a point. Exact spelling first; after a miss, a unique case-insensitive catalog match is retried."
}
},
"additionalProperties": false
}| limit | integer | Requested stops on this page, 1–10,000; applied cap is at most 200. Default 15. |
| month | string | Month as YYYY-MM, or the last month of the range with month_from. Omitted: the latest published month, echoed as month in the result. |
| offset | integer | Rows to skip before this page; pass next_offset from the previous result. Default 0. |
| filters | array | Up to 8 filters, all of which a stop must match; they narrow the counts and the page together. Fields: type, self_defined_ethnicity, officer_defined_ethnicity, outcome, object_of_search, legislation, age_range, gender, outcome_linked_to_object_of_search, removal_of_more_than_outer_clothing. |
| polygon | array | 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. |
| month_from | string | First month of a range, YYYY-MM, searched through month — up to 12 months, with a total for each in by_month. Omitted: month alone. |
| location_id | string | For area 'location': location.location_id from an earlier result — one anonymised map point. |
| neighbourhood_id | string | For area 'neighbourhood', with force: a neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', or from ukcrime_find_neighbourhood for a point. Exact spelling first; after a miss, a unique case-insensitive catalog match is retried. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"area"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, WGS84 decimal degrees, for area 'point'."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, WGS84 decimal degrees, for area 'point'."
},
"area": {
"enum": [
"point",
"polygon",
"location",
"neighbourhood",
"force"
],
"type": "string",
"description": "Area to search: 'point' (lat and lng; a 1-mile radius), 'polygon' (polygon), 'location' (location_id), 'neighbourhood' (force and neighbourhood_id), or 'force' (force alone: every stop the force published for the month or range, placed or not). An area field the chosen area does not use is rejected."
},
"force": {
"type": "string",
"pattern": "^\\s*[A-Za-z](?:[A-Za-z\\s&_-]*[A-Za-z])?\\s*$",
"maxLength": 100,
"description": "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. For area 'neighbourhood' (with neighbourhood_id) and 'force' (alone), where 'btp' (British Transport Police) is also accepted."
},
"limit": {
"type": "integer",
"default": 15,
"maximum": 10000,
"minimum": 1,
"description": "Requested stops on this page, 1–10,000; applied cap is at most 200. Default 15."
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "Month as YYYY-MM, or the last month of the range with month_from. Omitted: the latest published month, echoed as month in the result."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows to skip before this page; pass next_offset from the previous result. Default 0."
},
"filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value"
],
"properties": {
"field": {
"enum": [
"type",
"self_defined_ethnicity",
"officer_defined_ethnicity",
"outcome",
"object_of_search",
"legislation",
"age_range",
"gender",
"outcome_linked_to_object_of_search",
"removal_of_more_than_outer_clothing"
],
"type": "string",
"description": "Stop field to match."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "boolean"
}
],
"description": "Value to match exactly, case-insensitively, as the breakdowns show it: 'true' or 'false' for outcome_linked_to_object_of_search and removal_of_more_than_outer_clothing (a JSON true or false reads the same), and '(not recorded)' for stops with no value."
}
},
"description": "Keep only stops whose field equals value.",
"additionalProperties": false
},
"maxItems": 8,
"description": "Up to 8 filters, all of which a stop must match; they narrow the counts and the page together. Fields: type, self_defined_ethnicity, officer_defined_ethnicity, outcome, object_of_search, legislation, age_range, gender, outcome_linked_to_object_of_search, removal_of_more_than_outer_clothing."
},
"polygon": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude, WGS84 decimal degrees."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude, WGS84 decimal degrees."
}
},
"description": "One polygon vertex as { lat, lng }."
},
"maxItems": 2500,
"minItems": 3,
"description": "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."
},
"month_from": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "First month of a range, YYYY-MM, searched through month — up to 12 months, with a total for each in by_month. Omitted: month alone."
},
"location_id": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "For area 'location': location.location_id from an earlier result — one anonymised map point."
},
"neighbourhood_id": {
"type": "string",
"pattern": "^[^/\\\\?#]+$",
"maxLength": 100,
"description": "For area 'neighbourhood', with force: a neighbourhood id from ukcrime_list_reference topic 'neighbourhoods', or from ukcrime_find_neighbourhood for a point. Exact spelling first; after a miss, a unique case-insensitive catalog match is retried."
}
},
"additionalProperties": false
}