Search API

API Endpoints

Crime & Policing

Crime Rates

Tokens
× 1

API Credit Cost

Endpoint Overview

The Crime Incidents endpoint provides detailed information on street-level incidents within a specified radius of a postcode. This includes data on various crime categories, such as burglary, vehicle theft, and violent offences, along with their street location, date and outcome status.

Coverage

EnglandEngland
WalesWales

Update Frequency

Monthly

Request Format

HTTP Method:

GET

To use the API you should send an HTTP request to the following endpoint URL. This will return a JSON response.

https://api.postcodearea.co.uk/crime-incidents/?key=&postcode={postcode}

Note that your key has automatically been added to the API endpoint for convenience.

Querystring Parameters:

{postcode}

A valid UK postcode (e.g., SW1A 1AA). Note that you can send the postcode with or without the space separating the outward and inward codes. For example, both "SW1A 1AA" and "SW1A1AA" are both valid.

{api_key}

A valid API key that authenticates your account.

Authorisation

For every endpoint request your API Key should be sent as part of the querystring:

https://api.postcodearea.co.uk/crime-incidents/?key={api_key}&postcode=WS3+3PD

For example:

https://api.postcodearea.co.uk/crime-incidents/?key=&postcode=WS3+3PD

Example Request and Response

If the above URL endpoint exists and the API key is valid, our system will return the following example response:

https://api.postcodearea.co.uk/crime-incidents/?key=&postcode=WS3+3PD
{"data":[{"category":"anti-social-behaviour","location_type":"Force","location":{"latitude":"52.778412","street":{"id":1745619,"name":"On or near Waterside Court"},"longitude":"-2.265200"},"context":"","outcome_status":null,"persistent_id":"","id":125095854,"location_subtype":"","month":"2024-12"},{"category":"drugs","location_type":"Force","location":{"latitude":"52.781181","street":{"id":1745478,"name":"On or near Plardiwick Road"},"longitude":"-2.268923"},"context":"","outcome_status":{"category":"Awaiting court outcome","date":"2024-12"},"persistent_id":"043e92ed8099e6edda51ac132fe52c2d135a89c61c8137f7eee198ad9dc6a00a","id":125090119,"location_subtype":"","month":"2024-12"},{"category":"other-theft","location_type":"Force","location":{"latitude":"52.786954","street":{"id":1746177,"name":"On or near Parking Area"},"longitude":"-2.236027"},"context":"","outcome_status":{"category":"Investigation complete; no suspect identified","date":"2024-12"},"persistent_id":"4c2f5360bb5dae7e9c82458f111113177f53bbb3dd98450819b8e6ca4eb2ad22","id":125089102,"location_subtype":"","month":"2024-12"},{"category":"public-order","location_type":"Force","location":{"latitude":"52.782940","street":{"id":1745955,"name":"On or near Osborne Park"},"longitude":"-2.250119"},"context":"","outcome_status":{"category":"Under investigation","date":"2024-12"},"persistent_id":"709d83f13c4952caa5c7e475b1a36efead54d99430331650a9ecd5a152ed1184","id":125093515,"location_subtype":"","month":"2024-12"},{"category":"public-order","location_type":"Force","location":{"latitude":"52.778412","street":{"id":1745619,"name":"On or near Waterside Court"},"longitude":"-2.265200"},"context":"","outcome_status":{"category":"Under investigation","date":"2024-12"},"persistent_id":"5fd4b7f6e7e5fe8011c1e6fae319a5338250262f313f0af2468fd77524cf28bf","id":125090762,"location_subtype":"","month":"2024-12"},{"category":"public-order","location_type":"Force","location":{"latitude":"52.783005","street":{"id":1745899,"name":"On or near Petrol Station"},"longitude":"-2.255571"},"context":"","outcome_status":{"category":"Under investigation","date":"2024-12"},"persistent_id":"f0491d2d811bd193539f9a052e33159fb702338ff846f67fd5ce679d4834b20f","id":125090763,"location_subtype":"","month":"2024-12"},{"category":"vehicle-crime","location_type":"Force","location":{"latitude":"52.786225","street":{"id":1745890,"name":"On or near Doley Close"},"longitude":"-2.256469"},"context":"","outcome_status":{"category":"Investigation complete; no suspect identified","date":"2024-12"},"persistent_id":"be7252c09ef45e3e8ac7259559f7814f9e6cce501ff516e126147d32a6764fba","id":125092056,"location_subtype":"","month":"2024-12"},{"category":"vehicle-crime","location_type":"Force","location":{"latitude":"52.778112","street":{"id":1745698,"name":"On or near Monks Walk"},"longitude":"-2.262678"},"context":"","outcome_status":{"category":"Under investigation","date":"2024-12"},"persistent_id":"ed966d48fa8f3da5758f1225947887c5b4f50d3c4fb5c510c277fc09d273138e","id":125094029,"location_subtype":"","month":"2024-12"},{"category":"violent-crime","location_type":"Force","location":{"latitude":"52.778112","street":{"id":1745698,"name":"On or near Monks Walk"},"longitude":"-2.262678"},"context":"","outcome_status":{"category":"Under investigation","date":"2024-12"},"persistent_id":"2cc62c86627e426cfd145c1e35c731f00fe263f964f307fd67f68e594ef19d51","id":125094043,"location_subtype":"","month":"2024-12"},{"category":"violent-crime","location_type":"Force","location":{"latitude":"52.778253","street":{"id":1745641,"name":"On or near Impstones"},"longitude":"-2.264013"},"context":"","outcome_status":{"category":"Under investigation","date":"2024-12"},"persistent_id":"d2e608432988947c4d7fc99514c46a0becde45559a3130dc3c1eeeceb0c39b8a","id":125094042,"location_subtype":"","month":"2024-12"},{"category":"violent-crime","location_type":"Force","location":{"latitude":"52.787928","street":{"id":1745799,"name":"On or near Shelmore Way"},"longitude":"-2.259030"},"context":"","outcome_status":{"category":"Unable to prosecute suspect","date":"2024-12"},"persistent_id":"d9514aa8b7535b1090cac9e17b6bcb659edc4078af715b5d39c3f320a9b417e5","id":125089483,"location_subtype":"","month":"2024-12"},{"category":"violent-crime","location_type":"Force","location":{"latitude":"52.787867","street":{"id":1746052,"name":"On or near Sharman Way"},"longitude":"-2.249495"},"context":"","outcome_status":{"category":"Under investigation","date":"2024-12"},"persistent_id":"35e5a502482a070029d95bc6b765951212a5437760104027bcef832050aefe1c","id":125093635,"location_subtype":"","month":"2024-12"}],"response_time":0.0156,"Source":"PostcodeArea API","Output Area":"LSOA","Radius":10,"Distance Unit":"Mile","Records":-1,"Unique Fields":1,"Referrer":"api.postcodearea.co.uk","Host":"https://api.postcodearea.co.uk/crime-incidents/?key=pa_XWQAV24RXCUU19NGUFM11TKTLN&postcode=st200ly","Endpoint":"/crime-incidents/?key=pa_XWQAV24RXCUU19NGUFM11TKTLN&postcode=st200ly"}

Error Handling

HTTP Status Code Error Message Reason
400 Invalid postcode format The postcode provided is not valid.
401 Unauthorised request API key missing or invalid.
404 Postcode not found No data available for the given postcode.
404 No Results Found No data available for the given radius.
429 Too many requests Exceeded rate limit.
500 Internal server error An unexpected issue occurred.

Caching Policy

You may temporarily cache data retrieved from the API for performance optimisation purposes, provided that the cached data is:

  1. Stored in-memory only (e.g., application-level cache).
  2. Retained for no longer than one hour.

Caching API data to any persistent storage, including but not limited to databases, files, or external systems, constitutes a breach of our API Terms and Conditions. Such actions are strictly prohibited to ensure data accuracy and compliance with our licensing agreements.

If you have specific requirements for extended caching, you must seek prior written consent from us.

Get started today

Ready to use this data for your own business or organisation? Sign up today and get immediate access to all the PostcodeArea API endpoints.

Sign up and access the API-or-Explore the docs

Share this page