Find cases (cohort)
find_casesFilter FY2015–FY2025 federal civil cases by nature of suit, court, jurisdiction, disposition, pro se status, class action or MDL, then return a cohort handle and count for analysis.
Instructions
Use this when the question needs case-level filters the published tables don't have: a case type (nature of suit), origin (for example directly filed MDL cases), jurisdiction, disposition, pro se status, class actions or an MDL docket, for FY2015–FY2025 civil cases in the FJC Integrated Database. "How many employment discrimination cases were filed in N.D. Ill. in FY2024?"
Never guess a nature-of-suit code: for a case type in words ("patent"), get the code from explain_term first, then check case_types in the result.
Not for published totals without filters (use get_official_figure: it is authoritative) or for rankings (compare_courts).
Returns a cohort handle (coh_…), the count, the label of each nature-of-suit code filtered on (case_types) and a small preview (by fiscal year, top courts, top case types, MDL share); never case rows or party names. Pass the handle to analyze_cohort for medians, outcome rates and trends, or to sample_dockets for example dockets. To narrow a cohort, call again with parent_handle and the extra filters.
Example: courts=['FL-N'], fy_from=2020, fy_to=2020, origins=['mdl_direct'] → 202,463 cases, handle coh_1385a2b1481d.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"fy_from": "<fy_from>",
"fy_to": "<fy_to>"
},
"name": "find_cases"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| basis | No | Cases filed in those years, or terminations in them. | filed |
| fy_to | Yes | Last fiscal year. | |
| courts | No | Districts or circuits; omit for all districts. | |
| pro_se | No | ||
| fy_from | Yes | First fiscal year. | |
| origins | No | e.g. ['mdl_direct'] for directly filed MDL cases. | |
| nos_codes | No | Nature-of-suit codes the user gave or explain_term returned, never guessed: e.g. ['442'] employment discrimination, ['830'] patent. | |
| mdl_docket | No | MDL docket number, e.g. '2885'. | |
| nos_groups | No | Table C-2 groups, e.g. ['Civil Rights']. | |
| exclude_mdl | No | Drop MDL cases (direct and transferred). | |
| class_action | No | ||
| dispositions | No | ||
| jurisdictions | No | ||
| parent_handle | No | Refine this cohort: its filters plus the ones given. | |
| nos_categories | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| status | No | ok | |
| declined | No | ||
| warnings | No | ||
| provenance | No | ||
| clarification | No | ||
| suggested_next | No | Hints for a follow-up call. |