FBI Get Crime Estimates
fbi_get_crime_estimatesRead-onlyIdempotent
Monthly offense rates (per 100k population), raw counts, population denominators and provider reporting coverage from FBI CDE. National scope omits identifiers; state requires only state_abbr; agency requires only ori. Identifiers are case-insensitive; start must be no later than end. Missing coverage stays null and participation may be incomplete. Offenses: violent-crime, property-crime, robbery, burglary, larceny, motor-vehicle-theft, arson, aggravated-assault, rape, homicide.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ori | No | Nine ASCII-letter/digit ORI code (e.g. CA0010400, DCMPD0000); case-insensitive. Only permitted and required for agency scope. | |
| scope | Yes | Geographic scope: national (omit identifiers), state (only state_abbr), or agency (only ori). | |
| offense | Yes | Offense type: violent-crime, property-crime, robbery, burglary, larceny, motor-vehicle-theft, arson, aggravated-assault, rape, or homicide. | |
| to_year | Yes | End year of the data range (inclusive). | |
| to_month | No | End month (1–12). Defaults to December. | |
| from_year | Yes | Start year of the data range (inclusive). The API uses monthly granularity. | |
| from_month | No | Start month (1–12). Defaults to January. | |
| state_abbr | No | Two ASCII-letter state abbreviation (e.g. CA, DC, PR); case-insensitive. Only permitted and required for state scope. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End of data range (MM-YYYY). | |
| ori | No | ORI code when scope is "agency". | |
| from | No | Start of data range (MM-YYYY). | |
| error | No | Present when the call failed. Absent on success. | |
| scope | No | Geographic scope. | |
| months | No | Monthly data rows sorted chronologically. | |
| offense | No | Offense type queried. | |
| state_abbr | No | State abbreviation when scope is "state". | |
| entity_name | No | Provider entity selected from scoped offense actuals. | |
| total_months | No | Number of months returned. | |
| max_data_date | No | Latest data date reported by CDE, in the provider format. | |
| data_last_updated | No | Date the CDE last refreshed this data. |