Get an official figure
get_official_figureRetrieve one official federal court statistic by court and fiscal year, including citation, edition provenance and revision notes. Use for single figures, not rankings or filtered case counts.
Instructions
Use this when the user asks for a single published statistic: one measure, one court (or the nation), one fiscal year, e.g. civil cases pending in S.D.N.Y. in FY2023 or the national median time to disposition.
Not for rankings across courts (use compare_courts), for why a number changed between years (use explain_change), or for counts with filters such as case type (use find_cases).
Returns the value in the latest edition by default, the first-published value, every edition that printed it and, when editions disagree, revision_notes on why. Quote citation with the number, even if asked for one number: it names the edition and any revision. Relay an 'inferred' note as inference. For a 12-month period not ending September 30 (e.g. ending June 30), pass period_ending and relay what the server says. A plain "civil filings" means civil_cases_filed and "civil filings per judgeship" the unweighted civil_filings_per_judgeship (the tables' own labels); pass 'filings_per_judgeship' only for vague asks that name neither.
Example: measure='weighted_civil_filings_per_judgeship', court='US', fiscal_year=2020 → 322 (JFF-2025), first published as 554 (JB-2020).
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": {
"measure": "<measure>",
"fiscal_year": "<fiscal_year>"
},
"name": "get_official_figure"
}
}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 |
| edition | No | Which edition's figure to return: 'latest' (default: the current official figure), 'first_published', or a specific edition such as JB-2020 or JFF-2023. | latest |
| measure | Yes | A published statistic. If the user didn't say whether they mean weighted or unweighted filings, pass 'filings_per_judgeship' (or 'civil_filings') and the server will ask them. | |
| fiscal_year | Yes | Fiscal year (ends September 30). | |
| period_ending | No | End of the 12-month period: 'september_30' (fiscal year, default) or another quarter end the user asked about. | september_30 |
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. |