Reconcile IDB vs official
reconcileCompares IDB civil case counts or a find_cases handle against official federal court Table C-1 figures, reporting variance and match status by court and fiscal year.
Instructions
Use this when the user asks whether case-level data matches the official tables, or how far an IDB count is from the published one: civil cases filed, terminated or pending for a court and fiscal year (Table C-1), or a find_cases handle that corresponds to one (courts, one year, no filters).
Not for the official figure itself (get_official_figure) or for explaining a change over time (explain_change).
Returns the official value (latest edition, with every edition), the IDB rebuild, the variance and a badge: matched, explained_variance (with the quantified cause: a restated figure, repeat records, undated reopenings or snapshot drift) or unexplained.
Example: measure='civil_cases_pending', court='US', fiscal_year=2017 → official 366,195 (JB-2018, restated from 339,131), IDB 363,601, matched.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "reconcile"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| court | No | Court code: US (all district courts), a circuit (CIR-01 … CIR-11, CIR-DC) or a district (state postal code, plus -N/-E/-S/-W/-M/-C for divided states: FL-N = N.D. Fla., NY-S = S.D.N.Y., DC = D.D.C.). | US |
| handle | No | Or: a find_cases handle to reconcile instead. | |
| measure | No | The count to rebuild (with court and fiscal_year). | |
| fiscal_year | 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. |