Time series · crime-monthly
Crimes reported each month, by state
Violent and property crimes reported to the FBI by police in every state each month since 2018, with how many were cleared and how much of the state's population the reporting agencies cover. Reported figures, not estimates: the coverage columns say how complete each month is.
- Updates
- Monthly
- Coverage
- —
- Current version
- —
- Last published
- —
- Validation
- —
- License
- US Government work
- Commercial use
- Allowed
Chart
Use the API
Each series and location is its own small file. The examples follow the series and location picked above. See the docs for versions, caching and errors.
curl
# One series for one place (.json or .csv)
curl -s "https://api.justicedata.dev/v1/crime-monthly/violent-crime/usa.json"
# Every series and place in one file
curl -sO "https://api.justicedata.dev/v1/crime-monthly/download/crime-monthly.csv"Python (polars)
import polars as pl
# One series for one place
df = pl.read_csv("https://api.justicedata.dev/v1/crime-monthly/violent-crime/usa.csv")
# Every series and place, with series and location columns
everything = pl.read_parquet("https://api.justicedata.dev/v1/crime-monthly/download/crime-monthly.parquet")JavaScript
const res = await fetch("https://api.justicedata.dev/v1/crime-monthly/violent-crime/usa.json");
if (!res.ok) throw new Error((await res.json()).detail); // errors are problem+json
const { meta, data } = await res.json();
console.log(meta.location_name, data.at(-1)); // { date, value, ... }Downloads
The whole dataset in one file, with series and location columns. Parquet keeps the column types and is much smaller.
- crime-monthly.csv CSV
- crime-monthly.parquet Parquet
Schema and series
Each series file has these columns. The bulk downloads add series and location columns in
front.
| Column | Type | Unit | Can be empty | Description |
|---|---|---|---|---|
| date | month (YYYY-MM) | — | no | — |
| offenses | integer | offenses | yes | Offenses reported by the state's agencies; null for the US |
| clearances | integer | offenses | yes | Offenses cleared by arrest or exceptional means; null for the US |
| offense_rate | number | per 100k | yes | Offenses per 100,000 people covered by the reporting agencies |
| clearance_rate | number | per 100k | yes | Clearances per 100,000 people covered by the reporting agencies |
| coverage_pct | number | % | yes | Percent of the population covered by agencies that reported that month |
| population | integer | people | yes | Population of the state (or US) used by the FBI |
| covered_population | integer | people | yes | Population covered by the agencies that reported |
Series
| Series id | Name |
|---|---|
| violent-crime | Violent crime (murder and nonnegligent manslaughter, rape, robbery, aggravated assault) |
| property-crime | Property crime (burglary, larceny-theft, motor vehicle theft) |
Locations
Covers all 57 US states and equivalents (ids: us- plus the USPS code (us-ca, us-dc)); 1 more named place.
| Location id | Name |
|---|---|
| usa | United States |
Place names come from the shared location registry; see Sources.
Source and license
- Source
- FBI Crime Data Explorer, summarized reported offenses by state (CDE API)
- Publisher
- Federal Bureau of Investigation (FBI), Uniform Crime Reporting Program
- License
- US Government work (public domain in the United States) (
LicenseRef-US-Government-Work) - Commercial use
- Allowed
Credit the source with this exact text:
Federal Bureau of Investigation, Crime Data Explorer, https://cde.ucr.cjis.gov/ (summarized offenses, via the CDE API on api.data.gov).
Checked every 7 days. If the source hasn't changed in 3 months, the status page flags it as stale.
Endpoints
Every URL for this dataset. To pin the current version, put it after the id:
/v1/crime-monthly@<version>.
The API reference describes each response.
| What | URL |
|---|---|
| Metadata: version, coverage, downloads, validation | /v1/crime-monthly |
| Versions and monthly snapshots | /v1/crime-monthly/versions |
| Series and locations | /v1/crime-monthly/locations |
| Violent crime (murder and nonnegligent manslaughter, rape, robbery, aggravated assault) (JSON) | /v1/crime-monthly/violent-crime/{location}.json |
| Violent crime (murder and nonnegligent manslaughter, rape, robbery, aggravated assault) (CSV) | /v1/crime-monthly/violent-crime/{location}.csv |
| Property crime (burglary, larceny-theft, motor vehicle theft) (JSON) | /v1/crime-monthly/property-crime/{location}.json |
| Property crime (burglary, larceny-theft, motor vehicle theft) (CSV) | /v1/crime-monthly/property-crime/{location}.csv |
| Whole dataset (CSV) | /v1/crime-monthly/download/crime-monthly.csv |
| Whole dataset (Parquet) | /v1/crime-monthly/download/crime-monthly.parquet |