{"ok":true,"site":"data-police","host":"data.police.uk","about":"data.police.uk is the UK's open police data API. This CLI covers forces and senior officers, street-level crimes and outcomes, neighbourhood teams, events and priorities, stop and search records, data availability dates, and the custom CSV download form.","commands":[{"command":"list-forces","summary":"List all police forces (id and name). Use the id in other commands.","params":[],"exampleUrl":"https://clify-dev.netlify.app/data-police/list-forces"},{"command":"get-force","summary":"Get one police force's details: website, phone number and engagement channels such as social media.","params":[{"name":"force","type":"string","required":true,"description":"Force id from list-forces"}],"exampleUrl":"https://clify-dev.netlify.app/data-police/get-force"},{"command":"list-force-officers","summary":"List the senior officers of a police force, with rank and bio.","params":[{"name":"force","type":"string","required":true,"description":"Force id from list-forces"}],"exampleUrl":"https://clify-dev.netlify.app/data-police/list-force-officers"},{"command":"list-crime-categories","summary":"List the crime categories (url slug and name) that were valid for a given month.","params":[{"name":"date","type":"string","description":"Month in YYYY-MM format. Omit for the latest month."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/list-crime-categories?date=2024-01"},{"command":"list-dates","summary":"List the months that have street-level data available, and which forces published stop and search data for each month.","params":[],"exampleUrl":"https://clify-dev.netlify.app/data-police/list-dates"},{"command":"get-last-updated","summary":"Get the date the crime data was last updated (this is the latest month available).","params":[],"exampleUrl":"https://clify-dev.netlify.app/data-police/get-last-updated"},{"command":"street-crimes","summary":"Street-level crimes for one month, either within a 1-mile radius of a lat/lng point or inside a custom polygon. Can be limited to one category.","params":[{"name":"category","type":"string","description":"Crime category slug (see list-crime-categories)","oneOf":["all-crime","anti-social-behaviour","bicycle-theft","burglary","criminal-damage-arson","drugs","other-theft","possession-of-weapons","public-order","robbery","shoplifting","theft-from-the-person","vehicle-crime","violent-crime","other-crime"],"default":"all-crime"},{"name":"lat","type":"string","description":"Latitude of the centre point. Use with lng; do not combine with poly."},{"name":"lng","type":"string","description":"Longitude of the centre point. Use with lat."},{"name":"poly","type":"string","description":"Polygon as lat,lng pairs separated by colons, e.g. 52.268,0.543:52.794,0.238:52.130,0.478. Use instead of lat/lng."},{"name":"date","type":"string","description":"Month in YYYY-MM format. Omit for the latest month."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/street-crimes?lat=52.629729&lng=-1.131592&poly=52.268%2C0.543%3A52.794%2C0.238%3A52.130%2C0.478&date=2024-01"},{"command":"crimes-at-location","summary":"Crimes recorded at the anonymised location nearest to a lat/lng point, or at a specific street location id, for one month.","params":[{"name":"date","type":"string","description":"Month in YYYY-MM format"},{"name":"lat","type":"string","description":"Latitude. Use with lng."},{"name":"lng","type":"string","description":"Longitude. Use with lat."},{"name":"location_id","type":"string","description":"Street location id (location.street.id from crime results). Use instead of lat/lng."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/crimes-at-location?date=2024-01&lat=52.629729&lng=-1.131592&location_id=1738423"},{"command":"crimes-no-location","summary":"Crimes a force recorded in one month that could not be mapped to a location.","params":[{"name":"force","type":"string","required":true,"description":"Force id from list-forces"},{"name":"category","type":"string","description":"Crime category slug","oneOf":["all-crime","anti-social-behaviour","bicycle-theft","burglary","criminal-damage-arson","drugs","other-theft","possession-of-weapons","public-order","robbery","shoplifting","theft-from-the-person","vehicle-crime","violent-crime","other-crime"],"default":"all-crime"},{"name":"date","type":"string","description":"Month in YYYY-MM format. Omit for the latest month."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/crimes-no-location?force=leicestershire&category=all-crime&date=2024-01"},{"command":"outcomes-at-location","summary":"Case outcomes recorded in one month near a lat/lng point, at a street location id, or inside a polygon. Each outcome includes the crime it relates to.","params":[{"name":"date","type":"string","description":"Month in YYYY-MM format"},{"name":"lat","type":"string","description":"Latitude. Use with lng."},{"name":"lng","type":"string","description":"Longitude. Use with lat."},{"name":"location_id","type":"string","description":"Street location id. Use instead of lat/lng."},{"name":"poly","type":"string","description":"Polygon as lat,lng:lat,lng:... Use instead of lat/lng."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/outcomes-at-location?date=2024-01&lat=52.629729&lng=-1.131592&location_id=1738423&poly=52.268%2C0.543%3A52.794%2C0.238%3A52.130%2C0.478"},{"command":"get-crime-outcomes","summary":"Get the full outcome history of one crime, looked up by its persistent_id.","params":[{"name":"persistent_id","type":"string","required":true,"description":"64-character persistent_id from crime results. Anti-social behaviour crimes have no persistent_id."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/get-crime-outcomes"},{"command":"list-neighbourhoods","summary":"List the neighbourhood policing areas (id and name) of a force.","params":[{"name":"force","type":"string","required":true,"description":"Force id from list-forces"}],"exampleUrl":"https://clify-dev.netlify.app/data-police/list-neighbourhoods"},{"command":"get-neighbourhood","summary":"Get one neighbourhood's details: name, centre point, description, links and contact details.","params":[{"name":"force","type":"string","required":true,"description":"Force id"},{"name":"neighbourhood","type":"string","required":true,"description":"Neighbourhood id from list-neighbourhoods or locate-neighbourhood"}],"exampleUrl":"https://clify-dev.netlify.app/data-police/get-neighbourhood"},{"command":"get-neighbourhood-boundary","summary":"Get a neighbourhood's boundary as a list of lat/lng points. These can be joined as lat,lng:lat,lng for the poly param of other commands.","params":[{"name":"force","type":"string","required":true,"description":"Force id"},{"name":"neighbourhood","type":"string","required":true,"description":"Neighbourhood id"}],"exampleUrl":"https://clify-dev.netlify.app/data-police/get-neighbourhood-boundary"},{"command":"list-neighbourhood-team","summary":"List the officers and PCSOs on a neighbourhood's policing team.","params":[{"name":"force","type":"string","required":true,"description":"Force id"},{"name":"neighbourhood","type":"string","required":true,"description":"Neighbourhood id"}],"exampleUrl":"https://clify-dev.netlify.app/data-police/list-neighbourhood-team"},{"command":"list-neighbourhood-events","summary":"List upcoming events for a neighbourhood, such as police drop-ins and community meetings.","params":[{"name":"force","type":"string","required":true,"description":"Force id"},{"name":"neighbourhood","type":"string","required":true,"description":"Neighbourhood id"}],"exampleUrl":"https://clify-dev.netlify.app/data-police/list-neighbourhood-events"},{"command":"list-neighbourhood-priorities","summary":"List a neighbourhood's policing priorities: each issue and the action taken on it.","params":[{"name":"force","type":"string","required":true,"description":"Force id"},{"name":"neighbourhood","type":"string","required":true,"description":"Neighbourhood id"}],"exampleUrl":"https://clify-dev.netlify.app/data-police/list-neighbourhood-priorities"},{"command":"locate-neighbourhood","summary":"Find which force and neighbourhood cover a lat,lng point.","params":[{"name":"q","type":"string","required":true,"description":"Coordinates as 'lat,lng', e.g. 52.629729,-1.131592"}],"exampleUrl":"https://clify-dev.netlify.app/data-police/locate-neighbourhood?q=52.629729%2C-1.131592"},{"command":"stops-street","summary":"Stop and searches in one month within a 1-mile radius of a lat/lng point, or inside a polygon.","params":[{"name":"lat","type":"string","description":"Latitude. Use with lng."},{"name":"lng","type":"string","description":"Longitude. Use with lat."},{"name":"poly","type":"string","description":"Polygon as lat,lng:lat,lng:... Use instead of lat/lng."},{"name":"date","type":"string","description":"Month in YYYY-MM format. Omit for the latest month."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/stops-street?lat=52.629729&lng=-1.131592&poly=52.268%2C0.543%3A52.794%2C0.238%3A52.130%2C0.478&date=2024-01"},{"command":"stops-force","summary":"All stop and searches a force reported for one month.","params":[{"name":"force","type":"string","required":true,"description":"Force id. See list-dates for which forces published stop and search data in which months."},{"name":"date","type":"string","description":"Month in YYYY-MM format. Omit for the latest month."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/stops-force?force=avon-and-somerset&date=2024-01"},{"command":"stops-no-location","summary":"Stop and searches a force reported for one month that could not be mapped to a location.","params":[{"name":"force","type":"string","required":true,"description":"Force id"},{"name":"date","type":"string","description":"Month in YYYY-MM format. Omit for the latest month."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/stops-no-location?force=cleveland&date=2024-01"},{"command":"stops-at-location","summary":"Stop and searches at a specific street location id for one month.","params":[{"name":"location_id","type":"string","required":true,"description":"Street location id (location.street.id from stops-street or crime results)"},{"name":"date","type":"string","description":"Month in YYYY-MM format. Omit for the latest month."}],"exampleUrl":"https://clify-dev.netlify.app/data-police/stops-at-location?location_id=2346580&date=2024-01"}]}