FBI Get Hate Crimes
fbi_get_hate_crimesRead-onlyIdempotent
Hate crime counts reported to FBI CDE for the nation, a state, or an agency, summed over a month window from January 1991 through the current year. Returns incidents by bias motivation and bias category, plus counts by offense type, location type, offender race, offender ethnicity, and federal judicial district, with every category CDE reports, zeros included. Narrow to one bias motivation with bias. National scope omits identifiers; state requires only state_abbr; agency requires only ori (look it up with fbi_search_agencies). CDE returns zeros both when nothing was reported and when it does not recognize a state or ORI.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ori | No | Nine ASCII-letter/digit ORI code (e.g. CA0010400, DCMPD0000); case-insensitive. Find an agency's ORI with fbi_search_agencies. Only permitted and required for agency scope. | |
| bias | No | Bias motivation code to narrow the counts to, or all (default). With a code, incidents count that motivation plus multiple-bias incidents that include it. Codes: 11 Anti-White; 12 Anti-Black or African American; 13 Anti-American Indian or Alaska Native; 14 Anti-Asian; 15 Anti-Multiple Races, Group; 16 Anti-Native Hawaiian or Other Pacific Islander; 21 Anti-Jewish; 22 Anti-Catholic; 23 Anti-Protestant; 24 Anti-Islamic (Muslim); 25 Anti-Other Religion; 26 Anti-Multiple Religions, Group; 27 Anti-Atheism/Agnosticism; 28 Anti-Church of Jesus Christ; 29 Anti-Jehovah's Witness; 31 Anti-Arab; 32 Anti-Hispanic or Latino; 33 Anti-Other Race/Ethnicity/Ancestry; 41 Anti-Gay (Male); 42 Anti-Lesbian (Female); 43 Anti-Lesbian, Gay, Bisexual, or Transgender (Mixed Group); 44 Anti-Heterosexual; 45 Anti-Bisexual; 51 Anti-Physical Disability; 52 Anti-Mental Disability; 61 Anti-Male; 62 Anti-Female; 71 Anti-Transgender; 72 Anti-Gender Non-Conforming; 81 Anti-Eastern Orthodox (Russian, Greek, Other); 82 Anti-Other Christian; 83 Anti-Buddhist; 84 Anti-Hindu; 85 Anti-Sikh. | all |
| scope | Yes | Geographic scope: national (omit identifiers), state (only state_abbr), or agency (only ori). | |
| to_year | Yes | End year of the data range (inclusive), 1991 through the current year. | |
| to_month | No | End month (1–12). Defaults to December. | |
| from_year | Yes | Start year of the data range (inclusive), 1991 through the current year. 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
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last month of the summed window (MM-YYYY). | |
| ori | No | Uppercased ORI code; present only for agency scope. | |
| bias | No | Bias motivation code applied, or all. | |
| from | No | First month of the summed window (MM-YYYY). | |
| error | No | Present when the call failed. Absent on success. | |
| scope | No | Geographic scope queried. | |
| notice | No | Present when every count is zero; says whether zeros can also mean an unrecognized state or ORI. | |
| bias_label | No | CDE label for the applied bias code; "All bias motivations" for all. | |
| state_abbr | No | Uppercased state abbreviation; present only for state scope. | |
| bias_section | No | CDE's bias_section breakdowns summed over the window. Each dimension is counted on its own basis, so the dimensions do not sum to one total or to the incident count. | |
| incident_section | No | Incident counts summed over the window. | |
| data_last_updated | No | Date CDE last refreshed hate crime data; absent when CDE omits it. |