FBI Search Agencies
fbi_search_agenciesFind law enforcement agencies in one state and their nine-character ORI codes, the identifier agency scope needs in fbi_get_crime_estimates, fbi_get_hate_crimes, fbi_get_arrests, and fbi_get_nibrs_breakdown. Fetches the state's full FBI CDE agency directory, filters it by words in the agency name, county, and agency type, sorts by agency name then ORI, and returns one page with the total match count and next_offset for the following page. Each agency carries its type, counties, and NIBRS reporting status. A code CDE has no directory for (AS, MP, or an unrecognized code) returns zero agencies with a notice.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Agencies per page (1–200). Defaults to 50. | |
| county | No | County name, case-insensitive (e.g. Bexar). Matches an agency when it equals any of the agency's counties, so an agency serving several counties matches each of them. | |
| offset | No | Zero-based position in the sorted matches; pass next_offset from the previous page. Defaults to 0. | |
| state_abbr | Yes | Two ASCII-letter state abbreviation (e.g. TX, DC, PR); case-insensitive. | |
| agency_type | No | Agency type: City, County, Other State Agency, Other, State Police, University or College, or Tribal. | |
| name_contains | No | Words or word fragments that must all appear in the agency name, in any order, case-insensitively (e.g. "san antonio police"). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied to this page. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Agencies on this page. | |
| total | No | Agencies matching the filters across the whole state directory, before paging. | |
| notice | No | Why the page is empty or partial, and the call to make next. | |
| offset | No | Zero-based position of the first agency on this page. | |
| agencies | No | This page of matching agencies, sorted by agency name, then ORI. | |
| truncated | No | True when more matching agencies follow this page; continue from next_offset. | |
| state_abbr | No | State code the directory was fetched for, uppercased. | |
| next_offset | No | Offset of the next page; absent on the last page. |