Case statistics
statsCompute one metric over cases (or motion rulings), optionally broken down by up to two dimensions and narrowed by filters. describe_dataset lists every metric and dimension and which unit each applies to. Groups of three or fewer cases are suppressed. At most 100 groups, largest first.
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": {
"metric": "<metric>"
},
"name": "stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metric | Yes | What to compute; see describe_dataset for each metric. | |
| um_uim | No | UM/UIM coverage is claimed. | |
| purpose | No | One sentence on what you are trying to find out. Logged to improve the dataset; never returned. | |
| district | No | Judicial district, e.g. HARTFORD JD. | |
| filed_to | No | Filed on or before this date (YYYY-MM-DD). | |
| group_by | No | Up to two dimensions to break the metric down by. | |
| case_type | No | Case type code: V01, V04 or V09. | |
| judge_key | No | Judge key from search_judges; matches the judge who decided the disposition. | |
| mechanism | No | How the crash happened, e.g. rear_end. | |
| road_type | No | Kind of road, e.g. interstate. | |
| filed_from | No | Filed on or after this date (YYYY-MM-DD). | |
| trial_kind | No | jury, court or not_tried. | |
| injury_kind | No | An alleged injury kind, e.g. fracture. | |
| injury_region | No | An injured body region, e.g. neck. | |
| plaintiff_role | No | driver, passenger, pedestrian… | |
| litigation_type | No | third_party, um_uim or subrogation. | |
| amount_in_demand | No | Amount-in-demand band, e.g. 15000_or_more. | |
| claims_lost_wages | No | Lost wages are claimed. | |
| firm_juris_number | No | Juris number from search_firms; matches either side's lead firm. | |
| commercial_vehicle | No | A commercial vehicle was involved. | |
| disposition_category | No | How the case ended, e.g. withdrawal or plaintiff_verdict; pending for open cases. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unit | Yes | What the metric counts: cases, or motion rulings for motion_grant_rate. | |
| names | Yes | Names of the judges and firms in the groups. | |
| groups | Yes | One entry per group, largest n first. | |
| metric | Yes | The metric computed. | |
| groupBy | Yes | The group_by dimensions, in order. | |
| closedTo | Yes | For metrics over closed cases, the last disposition date counted, inclusive: the as-of date. Null for metrics over every case. | |
| truncated | Yes | True when more groups exist than were returned. | |
| closedFrom | Yes | For metrics over closed cases, the first disposition date counted, inclusive; the figures are not all-time. Null for metrics over every case. | |
| totalGroups | Yes | Groups before the cap on how many are returned. | |
| groupsSuppressed | Yes | Returned groups that are suppressed. | |
| multiValuedDimensions | Yes | Dimensions where one case can sit in several groups, so group counts overlap. |