Welcome to the DEADLY FORCE REST API documentation.

Because one of our primary goals is to facilitate the distribution of data about police uses of deadly force, we provide a REST API that allows developers and others to access our complete data set programmatically and in close to real time. It is ideal for conducting research, creating visualizations, or developing automated means of distrusting our data.

The API follows standard RESTful web service design practices so making a request is easy:

Example response:


You can use the filter module below to experiment with different request parameters and view the response and updated url above.

Filters

Authentication


Access to the API requires an access token. The token is associated with your email address so we can see how the API is being used and get in contact with you if we need to (we won't share this with anyone or contact you without good reason).

Please fill out the form below to obtain an access token.

All requests must contain your access token as a GET parameter called access_token. For example:

https://api.deadlyforce.info/v1/incidents?access_token=YOUR_ACCESS_TOKEN

Rate Limiting

API usage is subject to rate limiting for all non-cached requests (if you make that same request more than once it will not be counted against you). The current rate limit is 1000 requests every hour. If you exceed the rate limit allowance an HTTP status code of 429 will be returned. If you need to increase your rate limit please contact support@deadlyforce.info.

Request Parameters


Global Parameters

These parameters can be passed for any requested resource.

fields
Optional

Specify only the fields you want to receive in the response. Multiple values can be separated by commas.

Examples: officer.name incident.shots_fired,victim.race

pretty_print
Optional

Enables printing of JSON with added whitespace. Defaults to false.

Examples: true false

Pagination Parameters

These parameters apply only to resources that return multiple results. For now this means only index resources (i.e. GET incidents).

page_size
Optional

Sets the number of objects to return per page. The default page size is 100. The maximum page size is 1000.

Example: 500

page
Optional

The results page number.

Example: 2

Search & Filtering Parameters

These parameters filter and search for results matching specific criterion. They apply only to resources that return multiple results. For now this means only index resources (i.e. GET incidents).

incident[date]
Optional

The date that the incident occurred. Accepts either a single date or a range separated by a comma. Dates should be formatted YYYY-MM-DD.

Example: 2015-01-19,2015-02-19

incident[address]
Optional

The address at which the incident took place.

Example: 1235 Fake St.

incident[city]
Optional

The city the incident took place in.

Example: District of Columbia

incident[county]
Optional

The county the incident took place in.

Example: Prince Georges

incident[state]
Optional

The state the incident took place in.

Example: NY

incident[location]
Optional

Searches the full formatted address based on Google geocoding.

Example: Long Beach, CA

incident[shots_fired]
Optional

The number of shots fired by the officer (if incident was a shooting). Accepts a single value or a range separated by a comma.

Example: 3,5

incident[description]
Optional

Brief user submitted description of the incident.

victim[name]
Optional

Name of the deceased.

Example: John Doe

victim[age]
Optional

Age of the deceased. Accepts a range or single value.

Example: 18,25

victim[gender]
Optional

Gender of the deceased.

Examples: Unknown Female Male Other

victim[race]
Optional

Race of the deceased.

victim[cod]
Optional

Cause of death.

Example: Gunshot

victim[mental_illness]
Optional

Subject mental illness if they had one.

victim[armed]
Optional

Was the subject armed at the time of the incident? Accepts 1 (yes) or 0 (no),

Example: 1

victim[weapon]
Optional

If the subject was armed, the kind of weapon they had.

agency[name]
Optional

Name of the responsible police agency or department.

Example: York Sheriff's Office

officer[name]
Optional

Name of the officer(s) involved responsible for the incident.

Example: John Doe

officer[age]
Optional

Age of the officer. Accepts a range or single value.

Example: 18,25

officer[gender]
Optional

Gender of the officer.

Examples: Unknown Female Male Other

officer[race]
Optional

Race of the officer.

created
Optional

The date that the record was created. Accepts either a single date or a range separated by a comma. Dates should be formatted YYYY-MM-DD.

Example: 2015-01-19,2015-02-19

modified
Optional

The date that the record was last updated. Accepts either a single date or a range separated by a comma. Dates should be formatted YYYY-MM-DD.

Example: 2015-01-19,2015-02-19

GET incidents


Resource URL

https://api.deadlyforce.info/v1/incidents

Example Request

GET https://api.deadlyforce.info/v1/incidents?access_token=YOUR_ACCESS_TOKEN

Example Response

[
    {
        "id": 38858,
        "date": "2018-04-29T00:00:00.000Z",
        "shots_fired": null,
        "auto_summary": "On April 29th, 2018 Brandon Busher was killed by police Laos.",
        "victim": {
            "name": "Brandon Busher",
            "race": "European-American\/White",
            "age": 38,
            "gender": "Male",
            "photo_thumb_url": null,
            "showed_mental_illness_symptoms": null,
            "weapon": null,
            "armed": null,
            "cod": null,
            "mental_illness_symptoms": null,
            "photo_url": null
        },
        "officer": {
            "race": null,
            "gender": null,
            "name": null,
            "age": null
        },
        "agency": {
            "name": null
        },
        "location": {
            "formatted_address": "Laos",
            "address": "",
            "city": null,
            "county": null,
            "coordinates": {
                "lon": "102.495496",
                "lat": "19.85627"
            },
            "accuracy": 1,
            "state": null,
            "postal_code": null
        },
        "source_original": [
            "KilledByPolice.net"
        ],
        "created": "2018-05-01T03:04:57.000Z",
        "modified": "2018-05-01T03:04:58.000Z"
    },
    {
        "id": 38854,
        "date": "2018-04-28T00:00:00.000Z",
        "shots_fired": null,
        "auto_summary": "On April 28th, 2018 Shukri Ali Said was killed by police Georgia, USA.",
        "victim": {
            "name": "Shukri Ali Said",
            "race": "Unknown",
            "age": 36,
            "gender": "Female",
            "photo_thumb_url": null,
            "showed_mental_illness_symptoms": null,
            "weapon": null,
            "armed": null,
            "cod": null,
            "mental_illness_symptoms": null,
            "photo_url": null
        },
        "officer": {
            "race": null,
            "gender": null,
            "name": null,
            "age": null
        },
        "agency": {
            "name": null
        },
        "location": {
            "formatted_address": "Georgia, USA",
            "address": "",
            "city": null,
            "county": null,
            "coordinates": {
                "lon": "-82.9000751",
                "lat": "32.1656221"
            },
            "accuracy": 1,
            "state": "GA",
            "postal_code": null
        },
        "source_original": [
            "KilledByPolice.net"
        ],
        "created": "2018-04-30T03:04:57.000Z",
        "modified": "2018-04-30T03:04:59.000Z"
    },
    {
        "id": 38848,
        "date": "2018-04-26T00:00:00.000Z",
        "shots_fired": null,
        "auto_summary": "On April 26th, 2018 Myra Lisa Micalizio was killed by police California, USA.",
        "victim": {
            "name": "Myra Lisa Micalizio",
            "race": "Unknown",
            "age": 56,
            "gender": "Female",
            "photo_thumb_url": null,
            "showed_mental_illness_symptoms": null,
            "weapon": null,
            "armed": null,
            "cod": null,
            "mental_illness_symptoms": null,
            "photo_url": null
        },
        "officer": {
            "race": null,
            "gender": null,
            "name": null,
            "age": null
        },
        "agency": {
            "name": null
        },
        "location": {
            "formatted_address": "California, USA",
            "address": "",
            "city": null,
            "county": null,
            "coordinates": {
                "lon": "-119.4179324",
                "lat": "36.778261"
            },
            "accuracy": 1,
            "state": "CA",
            "postal_code": null
        },
        "source_original": [
            "KilledByPolice.net"
        ],
        "created": "2018-04-28T03:04:39.000Z",
        "modified": "2018-04-28T03:04:42.000Z"
    },
    {
        "id": 38847,
        "date": "2018-04-25T00:00:00.000Z",
        "shots_fired": null,
        "auto_summary": "On April 25th, 2018 Isaac Jackson was killed by police Kentucky, USA.",
        "victim": {
            "name": "Isaac Jackson",
            "race": "Unknown",
            "age": 42,
            "gender": "Male",
            "photo_thumb_url": null,
            "showed_mental_illness_symptoms": null,
            "weapon": null,
            "armed": null,
            "cod": null,
            "mental_illness_symptoms": null,
            "photo_url": null
        },
        "officer": {
            "race": null,
            "gender": null,
            "name": null,
            "age": null
        },
        "agency": {
            "name": null
        },
        "location": {
            "formatted_address": "Kentucky, USA",
            "address": "",
            "city": null,
            "county": null,
            "coordinates": {
                "lon": "-84.2700179",
                "lat": "37.8393332"
            },
            "accuracy": 1,
            "state": "KY",
            "postal_code": null
        },
        "source_original": [
            "KilledByPolice.net"
        ],
        "created": "2018-04-27T03:04:40.000Z",
        "modified": "2018-04-27T03:04:42.000Z"
    },
    {
        "id": 38843,
        "date": "2018-04-24T00:00:00.000Z",
        "shots_fired": null,
        "auto_summary": "On April 24th, 2018 Demonjhea Jordan was killed by police Kentucky, USA.",
        "victim": {
            "name": "Demonjhea Jordan",
            "race": "African-American\/Black",
            "age": 21,
            "gender": "Male",
            "photo_thumb_url": null,
            "showed_mental_illness_symptoms": null,
            "weapon": null,
            "armed": null,
            "cod": null,
            "mental_illness_symptoms": null,
            "photo_url": null
        },
        "officer": {
            "race": null,
            "gender": null,
            "name": null,
            "age": null
        },
        "agency": {
            "name": null
        },
        "location": {
            "formatted_address": "Kentucky, USA",
            "address": "",
            "city": null,
            "county": null,
            "coordinates": {
                "lon": "-84.2700179",
                "lat": "37.8393332"
            },
            "accuracy": 1,
            "state": "KY",
            "postal_code": null
        },
        "source_original": [
            "KilledByPolice.net"
        ],
        "created": "2018-04-26T03:04:51.000Z",
        "modified": "2018-04-26T03:04:52.000Z"
    }
]

GET incidents/:id


Resource URL

https://api.deadlyforce.info/v1/incidents/:id

Example Request

GET https://api.deadlyforce.info/v1/incidents/10?access_token=YOUR_ACCESS_TOKEN

Example Response

[
    {
        "id": 10,
        "date": "2000-01-09T00:00:00.000Z",
        "shots_fired": null,
        "auto_summary": "On January 9th, 2000 Sonny Daniel Diaz was killed by a police officer at.",
        "victim": {
            "name": "Sonny Daniel Diaz",
            "age": 24,
            "gender": "Male",
            "photo_thumb_url": null,
            "showed_mental_illness_symptoms": null,
            "weapon": null,
            "race": null,
            "armed": null,
            "cod": "Gunshot",
            "mental_illness_symptoms": null,
            "photo_url": null
        },
        "officer": {
            "race": null,
            "gender": null,
            "name": null,
            "age": null
        },
        "agency": {
            "name": "Riverside County Sheriff's Office"
        },
        "location": {
            "formatted_address": "Suncrest Ave, Moreno Valley, CA 92553, USA",
            "address": "Suncrest Avenue",
            "city": "Moreno Valley",
            "county": "Riverside County",
            "coordinates": {
                "lon": "-117.2474136",
                "lat": "33.9250733"
            },
            "accuracy": 4,
            "state": "CA",
            "postal_code": "92553"
        },
        "source_original": [
            "FatalEncounters.org"
        ],
        "created": "2016-12-05T22:52:33.000Z",
        "modified": "2016-12-05T22:52:33.000Z"
    }
]