Server definition
- Hash
- sha256:51100ed707eae7eca88a69fbd5c1af99638ee01a811daec16ef5b0f46d5bb379
- What it is
- What a remote MCP server returned when asked what it offers: 14 tools
The blob, as servednamed by its sha256
{
"instructions": "CourtListener MCP server — access 9M+ US court opinions, RECAP federal dockets, judge records, citation networks, and oral arguments.\n- Start with courtlistener_lookup_courts to discover court IDs before filtering searches\n- CourtListener publishes free-tier limits of 5 req/min, 50/hr, 125/day, but actual limits vary by token tier. This server queues its own requests to the minute and hour windows, so a short burst waits rather than failing; a rate-limit error means the wait outlasted the call — honor its Retry-After\n- courtlistener_lookup_citation resolves citation strings (e.g., \"410 U.S. 113\") to cluster IDs\n- courtlistener_get_citations traces precedent networks (direction=\"cited_by\" for downstream influence)",
"tools": [
{
"description": "Retrieve the citation network for an opinion cluster. Supports two directions: \"cited_by\" (opinions that cite this one — measures precedential influence) and \"citing\" (opinions this one cites — reveals the authority chain relied on). This is the primary tool for tracing legal precedent chains. Note: the free tier supports shallow traversal — following 1–2 hops of a single case is practical; deep multi-hop analysis burns through the daily budget quickly.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cluster_id": {
"description": "Opinion cluster ID to retrieve citations for. Obtain from courtlistener_search_opinions or courtlistener_lookup_citation.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"court": {
"description": "Filter results to a specific court (e.g., \"scotus\", \"ca9\"). Applies to both directions.",
"type": "string"
},
"cursor": {
"description": "Pagination cursor from a previous response's next_cursor field.",
"type": "string"
},
"direction": {
"default": "cited_by",
"description": "\"cited_by\" (default): opinions that cite this one — measures precedential influence and downstream adoption. \"citing\": opinions this one cites — reveals the authority chain the court relied on.",
"enum": [
"citing",
"cited_by"
],
"type": "string"
},
"filed_after": {
"description": "Limit to citations filed after this date (ISO 8601). For \"cited_by\", useful for \"how has this precedent been applied recently?\"",
"type": "string"
},
"page_size": {
"default": 20,
"description": "Number of results to request (default 20). For direction=\"cited_by\", CourtListener enforces a minimum of 20 results per page regardless of the value passed — you will always receive at least 20 results. direction=\"citing\" returns at most page_size (the cited-opinion list is sliced before querying) — fewer when the opinion cites fewer than page_size distinct opinions. Either direction costs three requests against the rate limit (a case with many opinion variants costs one more per extra variant page) — keep low for multi-hop traversal.",
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"required": [
"cluster_id"
],
"type": "object"
},
"name": "courtlistener_get_citations",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"source_cluster_id",
"source_case_name",
"direction",
"results",
"next_cursor",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"direction": {
"description": "Direction of the citation relationship returned.",
"enum": [
"citing",
"cited_by"
],
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: Cluster ID does not exist in CourtListener. Both directions resolve the source cluster before searching, so a bad ID fails here rather than returning an empty network. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. `invalid_date`: filed_after is not a valid ISO 8601 calendar date. Other values are possible when a failure originates below the handler.",
"examples": [
"not_found",
"rate_limited",
"invalid_date"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"next_cursor": {
"description": "Pagination cursor for the next page; null when no more results.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Context when no citations are returned — either that this page had no match under the filters and more pages remain, or a recovery hint echoing direction and filters.",
"type": "string"
},
"results": {
"description": "Related opinions in the citation network.",
"items": {
"additionalProperties": false,
"description": "Related opinion in the citation network.",
"properties": {
"case_name": {
"description": "Case name of the related opinion.",
"type": "string"
},
"citations": {
"description": "Citation strings for the related opinion.",
"items": {
"type": "string"
},
"type": "array"
},
"cite_count": {
"description": "This opinion's own citation count — its authority weight.",
"type": "number"
},
"cluster_id": {
"description": "Cluster ID of the related opinion.",
"type": "number"
},
"court": {
"description": "Court that issued the related opinion.",
"type": "string"
},
"court_id": {
"description": "Court identifier for use in filter parameters.",
"type": "string"
},
"date_filed": {
"description": "Date the related opinion was filed.",
"type": "string"
},
"snippet": {
"description": "Matched text excerpt from the related opinion, taken from the first opinion variant in the cluster that carries one; empty string when none does. It is a relevance preview for the cluster, not necessarily text surrounding the citation itself.",
"type": "string"
}
},
"required": [
"cluster_id",
"case_name",
"court",
"court_id",
"date_filed",
"citations",
"cite_count",
"snippet"
],
"type": "object"
},
"type": "array"
},
"source_case_name": {
"description": "Case name for the source cluster.",
"type": "string"
},
"source_cluster_id": {
"description": "The cluster ID this citation network is for.",
"type": "number"
},
"totalCount": {
"description": "Total citations in the requested direction. For \"cited_by\" it counts matching clusters with the court and filed_after filters applied. For \"citing\" it counts the distinct opinions this case cites, before any filter — so it exceeds what the filters make reachable, and runs higher than the result rows, which are clusters (several cited opinions in one case collapse to one row).",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Fetch full docket metadata and entry list for a single federal case by docket ID. Returns all available docket entries with document availability status. Documents with is_available=true have a RECAP-stored copy; others require a PACER account. Obtain docket IDs from courtlistener_search_dockets or from opinion results.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"docket_id": {
"description": "Docket ID from a search result's docket_id field or from an opinion cluster result.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"entries_page": {
"default": 1,
"description": "Page of docket entries to fetch (1-indexed). Docket entries are page-paginated at 20 per page; pass the next_cursor from a previous response here to page through large cases.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"entries_page_size": {
"default": 20,
"description": "Requested docket entries per page. NOTE: CourtListener ignores this value — /docket-entries/ always returns a fixed 20-entry page regardless of what is passed. Use entries_page to reach entries beyond the first 20 (large cases can have hundreds).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"required": [
"docket_id"
],
"type": "object"
},
"name": "courtlistener_get_docket",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"docket_id",
"case_name",
"case_name_full",
"court",
"court_id",
"date_filed",
"date_terminated",
"docket_number",
"pacer_case_id",
"assigned_to",
"referred_to",
"cause",
"jury_demand",
"jurisdiction_type",
"total_entries",
"entries_page",
"next_cursor",
"entries"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"assigned_to": {
"description": "Assigned judge name; null if not recorded.",
"type": [
"string",
"null"
]
},
"case_name": {
"description": "Short case name.",
"type": "string"
},
"case_name_full": {
"description": "Full case name.",
"type": "string"
},
"cause": {
"description": "Legal cause of action.",
"type": "string"
},
"court": {
"description": "Court display name for major federal courts; the court identifier otherwise.",
"type": "string"
},
"court_id": {
"description": "Court identifier — the stable value for filtering.",
"type": "string"
},
"date_filed": {
"description": "Date the case was filed.",
"type": "string"
},
"date_terminated": {
"description": "Date the case was terminated; null if active.",
"type": [
"string",
"null"
]
},
"docket_id": {
"description": "Docket ID.",
"type": "number"
},
"docket_number": {
"description": "Docket number.",
"type": "string"
},
"entries": {
"description": "Docket entries for this page (fixed at 20 per page; entries_page_size is not honored by upstream).",
"items": {
"additionalProperties": false,
"description": "Docket entry with attached documents.",
"properties": {
"date_filed": {
"description": "Date this entry was filed.",
"type": "string"
},
"description": {
"description": "Entry description or filing type.",
"type": "string"
},
"documents": {
"description": "Documents attached to this docket entry.",
"items": {
"additionalProperties": false,
"description": "Document attached to a docket entry.",
"properties": {
"attachment_number": {
"description": "Attachment number; null for the main document.",
"type": [
"number",
"null"
]
},
"description": {
"description": "Document description.",
"type": "string"
},
"document_number": {
"description": "PACER document number as a string (e.g. \"1\"); attachments can be non-integer like \"70-1\". Null if not assigned.",
"type": [
"string",
"null"
]
},
"filepath_local": {
"description": "Fully-qualified RECAP storage URL (https://storage.courtlistener.com/...) for the document; null if not available.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Document ID.",
"type": "number"
},
"is_available": {
"description": "True if the document is available via RECAP without a PACER account.",
"type": "boolean"
},
"page_count": {
"description": "Page count; null if not recorded.",
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"document_number",
"attachment_number",
"description",
"is_available",
"page_count",
"filepath_local"
],
"type": "object"
},
"type": "array"
},
"entry_number": {
"description": "PACER entry number; null if not assigned.",
"type": [
"number",
"null"
]
},
"id": {
"description": "Docket entry ID.",
"type": "number"
}
},
"required": [
"id",
"entry_number",
"date_filed",
"description",
"documents"
],
"type": "object"
},
"type": "array"
},
"entries_page": {
"description": "Current entries page number (1-indexed).",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: Docket ID does not exist in CourtListener. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. Other values are possible when a failure originates below the handler.",
"examples": [
"not_found",
"rate_limited"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"jurisdiction_type": {
"description": "Jurisdiction type.",
"type": "string"
},
"jury_demand": {
"description": "Jury demand status.",
"type": "string"
},
"next_cursor": {
"description": "Next page number to pass as the `entries_page` argument (docket entries are page-paginated); null when this is the last page.",
"type": [
"string",
"null"
]
},
"pacer_case_id": {
"description": "PACER case ID; null if not in RECAP.",
"type": [
"string",
"null"
]
},
"referred_to": {
"description": "Referred judge name; null if not recorded.",
"type": [
"string",
"null"
]
},
"total_entries": {
"description": "Total number of docket entries available — may exceed the returned entries list.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Fetch a single judicial financial disclosure by ID with its parsed line-item rows — investments, debts, positions, reimbursements, non-investment and spouse income, agreements, and gifts. This is the itemized companion to courtlistener_search_financial_disclosures (which returns only category counts). Pass categories:[...] to select specific categories; omit for all. Coded value/income columns are decoded to readable dollar ranges. When the full itemization is too large to inline, the response lists each category as a retrievable section by byte size while keeping the filing metadata and counts — re-call with categories:[...] to pull specific categories in full. Obtain disclosure IDs from courtlistener_search_financial_disclosures (the disclosure_id field).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"categories": {
"description": "Line-item categories to return in full: investments, debts, positions, reimbursements, non_investment_incomes, spouse_incomes, agreements, gifts. Omit for all categories (or an outline if they overflow the inline budget). Also the re-call selector — after an outline response, re-call with the category names it lists.",
"items": {
"enum": [
"investments",
"debts",
"positions",
"reimbursements",
"non_investment_incomes",
"spouse_incomes",
"agreements",
"gifts"
],
"type": "string"
},
"type": "array"
},
"disclosure_id": {
"description": "Financial disclosure ID — the disclosure_id field from a courtlistener_search_financial_disclosures result.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"disclosure_id"
],
"type": "object"
},
"name": "courtlistener_get_financial_disclosure",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"disclosure_id",
"person_id",
"year",
"report_type",
"page_count",
"has_been_extracted",
"is_amended",
"pdf_url",
"counts",
"kind"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"agreements": {
"description": "Continuing agreements.",
"items": {
"additionalProperties": false,
"description": "A continuing agreement or arrangement (Part VIII).",
"properties": {
"date": {
"description": "Date of the agreement as filed.",
"type": "string"
},
"id": {
"description": "Agreement row ID.",
"type": "number"
},
"parties_and_terms": {
"description": "Parties to and terms of the agreement.",
"type": "string"
},
"redacted": {
"description": "True if the source row was partially redacted.",
"type": "boolean"
}
},
"required": [
"id",
"date",
"parties_and_terms",
"redacted"
],
"type": "object"
},
"type": "array"
},
"counts": {
"additionalProperties": false,
"description": "Count of line items in each disclosure category.",
"properties": {
"agreements": {
"description": "Number of reported agreements.",
"type": "number"
},
"debts": {
"description": "Number of reported debts/liabilities.",
"type": "number"
},
"gifts": {
"description": "Number of reported gifts.",
"type": "number"
},
"investments": {
"description": "Number of reported investments.",
"type": "number"
},
"non_investment_incomes": {
"description": "Number of reported non-investment income sources.",
"type": "number"
},
"positions": {
"description": "Number of reported outside positions.",
"type": "number"
},
"reimbursements": {
"description": "Number of reported reimbursements.",
"type": "number"
},
"spouse_incomes": {
"description": "Number of reported spouse income sources.",
"type": "number"
}
},
"required": [
"investments",
"gifts",
"debts",
"positions",
"reimbursements",
"agreements",
"non_investment_incomes",
"spouse_incomes"
],
"type": "object"
},
"debts": {
"description": "Debts and liabilities.",
"items": {
"additionalProperties": false,
"description": "A debt or liability (Part VII).",
"properties": {
"creditor": {
"description": "Creditor name (e.g. \"Wells Fargo Bank, NA\").",
"type": "string"
},
"description": {
"description": "Description of the liability.",
"type": "string"
},
"id": {
"description": "Debt row ID.",
"type": "number"
},
"redacted": {
"description": "True if the source row was partially redacted.",
"type": "boolean"
},
"value_range": {
"description": "Value of the debt as a dollar range; empty if none.",
"type": "string"
}
},
"required": [
"id",
"creditor",
"description",
"value_range",
"redacted"
],
"type": "object"
},
"type": "array"
},
"disclosure_id": {
"description": "Financial disclosure ID.",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: Disclosure ID does not exist in CourtListener. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. Other values are possible when a failure originates below the handler.",
"examples": [
"not_found",
"rate_limited"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"gifts": {
"description": "Reported gifts.",
"items": {
"additionalProperties": false,
"description": "A reported gift (Part VI).",
"properties": {
"description": {
"description": "What the gift was.",
"type": "string"
},
"source": {
"description": "Who provided the gift.",
"type": "string"
},
"value": {
"description": "Reported dollar value; empty if not stated.",
"type": "string"
}
},
"required": [
"description",
"source",
"value"
],
"type": "object"
},
"type": "array"
},
"has_been_extracted": {
"description": "True if line items were parsed from the PDF; category arrays are empty when false.",
"type": "boolean"
},
"investments": {
"description": "Investment holdings.",
"items": {
"additionalProperties": false,
"description": "An investment holding (Part VII).",
"properties": {
"description": {
"description": "Name of the holding (e.g. \"Citibank, N.A. Accounts\").",
"type": "string"
},
"id": {
"description": "Investment row ID.",
"type": "number"
},
"income_range": {
"description": "Income during the reporting period as a dollar range (e.g. \"$1 - $1,000\"); empty if none.",
"type": "string"
},
"income_type": {
"description": "Income type (e.g. \"Interest\", \"Dividend\", \"Rent\"); empty if none.",
"type": "string"
},
"redacted": {
"description": "True if the source row was partially redacted.",
"type": "boolean"
},
"transaction": {
"description": "Transaction during the period (e.g. \"Buy\", \"Sold\"); empty if none.",
"type": "string"
},
"transaction_date": {
"description": "Transaction date as filed; empty if none.",
"type": "string"
},
"transaction_gain_range": {
"description": "Gain realized on the transaction as a dollar range; empty if none.",
"type": "string"
},
"transaction_partner": {
"description": "Identity of the transaction partner; empty if none.",
"type": "string"
},
"transaction_value_range": {
"description": "Transaction value as a dollar range; empty if none.",
"type": "string"
},
"value_method": {
"description": "Valuation method (e.g. \"Cash/market value\", \"Appraisal\"); empty if none.",
"type": "string"
},
"value_range": {
"description": "Gross value at period end as a dollar range (e.g. \"$250,001 - $500,000\"); empty if none.",
"type": "string"
}
},
"required": [
"id",
"description",
"income_type",
"income_range",
"value_range",
"value_method",
"transaction",
"transaction_date",
"transaction_value_range",
"transaction_gain_range",
"transaction_partner",
"redacted"
],
"type": "object"
},
"type": "array"
},
"is_amended": {
"description": "True if this filing is an amendment.",
"type": "boolean"
},
"kind": {
"description": "'full' returns the requested category rows; 'outline' lists each category as a retrievable section (by byte size) when the itemization overflows the inline budget. Filing metadata and counts are present either way.",
"enum": [
"full",
"outline"
],
"type": "string"
},
"non_investment_incomes": {
"description": "Non-investment income sources.",
"items": {
"additionalProperties": false,
"description": "The filer's non-investment income (Part II).",
"properties": {
"amount": {
"description": "Amount as filed — usually a dollar string (e.g. \"$10,116.00\").",
"type": "string"
},
"date": {
"description": "Date as filed (e.g. \"3/10/2022\").",
"type": "string"
},
"id": {
"description": "Non-investment income row ID.",
"type": "number"
},
"redacted": {
"description": "True if the source row was partially redacted.",
"type": "boolean"
},
"source_type": {
"description": "Source and type of the income.",
"type": "string"
}
},
"required": [
"id",
"date",
"source_type",
"amount",
"redacted"
],
"type": "object"
},
"type": "array"
},
"page_count": {
"description": "Page count of the source filing; null if not recorded.",
"type": [
"number",
"null"
]
},
"pdf_url": {
"description": "URL to the source disclosure PDF; null if unavailable.",
"type": [
"string",
"null"
]
},
"person_id": {
"description": "Person ID of the filer — pass to courtlistener_get_judge; null if absent.",
"type": [
"number",
"null"
]
},
"positions": {
"description": "Outside positions.",
"items": {
"additionalProperties": false,
"description": "An outside position held by the filer (Part I).",
"properties": {
"id": {
"description": "Position row ID.",
"type": "number"
},
"organization": {
"description": "Organization or entity name.",
"type": "string"
},
"position": {
"description": "Position title (e.g. \"Governing Director\").",
"type": "string"
},
"redacted": {
"description": "True if the source row was partially redacted.",
"type": "boolean"
}
},
"required": [
"id",
"position",
"organization",
"redacted"
],
"type": "object"
},
"type": "array"
},
"reimbursements": {
"description": "Reimbursements.",
"items": {
"additionalProperties": false,
"description": "A travel/event reimbursement (Part IV).",
"properties": {
"date": {
"description": "Dates as filed (e.g. \"April 3-5, 2022\").",
"type": "string"
},
"id": {
"description": "Reimbursement row ID.",
"type": "number"
},
"items": {
"description": "Items reimbursed (e.g. \"Transportation, Lodging and Meals\").",
"type": "string"
},
"location": {
"description": "Location of the reimbursed event.",
"type": "string"
},
"purpose": {
"description": "Purpose of the reimbursement.",
"type": "string"
},
"redacted": {
"description": "True if the source row was partially redacted.",
"type": "boolean"
},
"source": {
"description": "Who provided the reimbursement (e.g. a law school).",
"type": "string"
}
},
"required": [
"id",
"source",
"date",
"location",
"purpose",
"items",
"redacted"
],
"type": "object"
},
"type": "array"
},
"report_type": {
"description": "Report type (Nomination, Initial, Annual, Final, or Unknown).",
"type": "string"
},
"retrieval_notice": {
"description": "How to re-call the tool for specific categories when the itemization overflows.",
"type": "string"
},
"sections": {
"description": "Retrievable categories, largest first — pass names to `categories` on a re-call.",
"items": {
"additionalProperties": false,
"description": "A retrievable category (by name) and its serialized byte size.",
"properties": {
"bytes": {
"description": "Serialized byte size of the section",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Section identifier — pass in `sections` to retrieve it",
"type": "string"
}
},
"required": [
"name",
"bytes"
],
"type": "object"
},
"type": "array"
},
"spouse_incomes": {
"description": "Spouse income sources.",
"items": {
"additionalProperties": false,
"description": "The filer's spouse income (Part III).",
"properties": {
"date": {
"description": "Date as filed.",
"type": "string"
},
"id": {
"description": "Spouse income row ID.",
"type": "number"
},
"redacted": {
"description": "True if the source row was partially redacted.",
"type": "boolean"
},
"source_type": {
"description": "Source and type of the spousal income.",
"type": "string"
}
},
"required": [
"id",
"source_type",
"date",
"redacted"
],
"type": "object"
},
"type": "array"
},
"year": {
"description": "Filing year.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Fetch full biographical profile for a single judge: positions on record — judicial appointments across all courts plus non-judicial roles — education, political affiliations, and ABA ratings. The position list is paginated upstream and walked under a page bound; the response reports whether it was truncated. Obtain person IDs from courtlistener_search_judges results.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"person_id": {
"description": "Judge person ID from a search result's person_id field. Identifies a specific judge across all courts they have served on.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"person_id"
],
"type": "object"
},
"name": "courtlistener_get_judge",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"person_id",
"name",
"gender",
"dob",
"dob_granularity",
"dob_city",
"dob_state",
"dod",
"dod_granularity",
"fjc_id",
"aba_ratings",
"political_affiliations",
"education",
"positions",
"positionsShown",
"truncated"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"aba_ratings": {
"description": "ABA qualification ratings, expanded to readable labels (e.g., \"Well Qualified\").",
"items": {
"type": "string"
},
"type": "array"
},
"dob": {
"description": "Date of birth as CourtListener stores it, always full ISO 8601 — but the month and day are placeholders unless dob_granularity is \"day\". Read dob_granularity before presenting this as an exact date. Null if not recorded.",
"type": [
"string",
"null"
]
},
"dob_city": {
"description": "City of birth; null if not recorded.",
"type": [
"string",
"null"
]
},
"dob_granularity": {
"description": "Precision actually recorded for dob: \"year\", \"month\", or \"day\". Null when CourtListener recorded no precision. An unrecognized upstream value passes through unchanged.",
"type": [
"string",
"null"
]
},
"dob_state": {
"description": "State of birth; null if not recorded.",
"type": [
"string",
"null"
]
},
"dod": {
"description": "Date of death as CourtListener stores it, always full ISO 8601 — precision qualified by dod_granularity, as with dob. Null if living or not recorded.",
"type": [
"string",
"null"
]
},
"dod_granularity": {
"description": "Precision actually recorded for dod: \"year\", \"month\", or \"day\". Null when CourtListener recorded no precision.",
"type": [
"string",
"null"
]
},
"education": {
"description": "Educational history.",
"items": {
"additionalProperties": false,
"description": "Education record.",
"properties": {
"degree": {
"description": "Raw CourtListener degree-level code (e.g. \"ba\"); null if not recorded.",
"type": [
"string",
"null"
]
},
"degree_label": {
"description": "Degree level expanded to a readable label (e.g. \"Juris Doctor (J.D.)\"). An unmapped code passes through as the code itself; null if not recorded.",
"type": [
"string",
"null"
]
},
"school": {
"description": "Educational institution name.",
"type": "string"
},
"year": {
"description": "Graduation year; null if not recorded.",
"type": [
"number",
"null"
]
}
},
"required": [
"school",
"degree",
"degree_label",
"year"
],
"type": "object"
},
"type": "array"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: Person ID does not exist in CourtListener. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. Other values are possible when a failure originates below the handler.",
"examples": [
"not_found",
"rate_limited"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"fjc_id": {
"description": "Federal Judicial Center ID for cross-referencing with FJC data; null if not available.",
"type": [
"number",
"null"
]
},
"gender": {
"description": "Gender.",
"type": "string"
},
"name": {
"description": "Full name.",
"type": "string"
},
"notice": {
"description": "Present only when positions[] was truncated: what was withheld.",
"type": "string"
},
"person_id": {
"description": "Person ID.",
"type": "number"
},
"political_affiliations": {
"description": "Political affiliation history.",
"items": {
"additionalProperties": false,
"description": "Political affiliation entry.",
"properties": {
"affiliation": {
"description": "Political party, expanded to a readable label (e.g., \"Democratic\").",
"type": "string"
},
"date_end": {
"description": "End date of this affiliation; null if current.",
"type": [
"string",
"null"
]
},
"date_start": {
"description": "Start date of this affiliation.",
"type": [
"string",
"null"
]
}
},
"required": [
"affiliation",
"date_start",
"date_end"
],
"type": "object"
},
"type": "array"
},
"positions": {
"description": "Positions on record, across all courts — judicial appointments plus non-judicial roles (private practice, prosecutor, professor), which carry no court and describe themselves in job_title. CourtListener paginates this list and the walk is bounded, so read the truncated flag before treating it as a complete career.",
"items": {
"additionalProperties": false,
"description": "Position record — judicial or otherwise.",
"properties": {
"appointer": {
"description": "Position URI of the appointing authority (e.g., \".../positions/123/\"), not resolved to a name; null if elected or not recorded.",
"type": [
"string",
"null"
]
},
"court": {
"description": "Court name.",
"type": "string"
},
"court_id": {
"description": "Court identifier — use to filter opinions by this judge.",
"type": "string"
},
"date_confirmation": {
"description": "Date confirmed; null if not recorded.",
"type": [
"string",
"null"
]
},
"date_nominated": {
"description": "Date nominated; null if not recorded.",
"type": [
"string",
"null"
]
},
"date_start": {
"description": "Date the position started as CourtListener stores it, always full ISO 8601 — the month and day are placeholders unless date_start_granularity is \"day\". Null if not recorded.",
"type": [
"string",
"null"
]
},
"date_start_granularity": {
"description": "Precision actually recorded for date_start: \"year\", \"month\", or \"day\". Null when CourtListener recorded no precision.",
"type": [
"string",
"null"
]
},
"date_termination": {
"description": "Date the position ended as CourtListener stores it, always full ISO 8601 — precision qualified by date_termination_granularity. Null if current.",
"type": [
"string",
"null"
]
},
"date_termination_granularity": {
"description": "Precision actually recorded for date_termination: \"year\", \"month\", or \"day\". Null when CourtListener recorded no precision.",
"type": [
"string",
"null"
]
},
"job_title": {
"description": "Free-text title for a role with no position_type code (e.g. \"Assistant district attorney\"); empty on judicial rows.",
"type": "string"
},
"nomination_process": {
"description": "Selection method, expanded to a readable label (e.g., \"Appointment (President)\"); null if not recorded.",
"type": [
"string",
"null"
]
},
"organization_name": {
"description": "Employer for a non-judicial role; empty on judicial rows, which use court.",
"type": "string"
},
"position_type": {
"description": "Raw CourtListener position-type code (e.g. \"jud\", \"c-jud\") — the value the /positions/ position_type filter takes. Empty for non-judicial roles, which describe themselves in job_title.",
"type": "string"
},
"position_type_label": {
"description": "Position type expanded to a readable label (e.g. \"Judge\", \"Chief Judge\"). An unmapped code passes through as the code itself; empty for non-judicial roles.",
"type": "string"
},
"termination_reason": {
"description": "Raw CourtListener termination-reason code (e.g. \"other_pos\"); null if still serving.",
"type": [
"string",
"null"
]
},
"termination_reason_label": {
"description": "Termination reason expanded to a readable label (e.g. \"Appointed to Other Judgeship\"). An unmapped code passes through as the code itself; null if still serving.",
"type": [
"string",
"null"
]
}
},
"required": [
"court",
"court_id",
"position_type",
"position_type_label",
"job_title",
"organization_name",
"appointer",
"nomination_process",
"date_nominated",
"date_confirmation",
"date_start",
"date_start_granularity",
"date_termination",
"date_termination_granularity",
"termination_reason",
"termination_reason_label"
],
"type": "object"
},
"type": "array"
},
"positionsShown": {
"description": "Number of position records returned.",
"type": "number"
},
"truncated": {
"description": "True when the bounded /positions/ page walk stopped with pages outstanding — positions[] is then a prefix of the person's record, not the whole of it. False when the walk reached the end.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Fetch the full text and metadata for a single opinion cluster by cluster ID. A cluster groups all opinions filed in a case — majority, concurrence, dissent, and per curiam. Returns the cluster metadata (case name, court, citations, dates) plus every opinion variant with HTML and plain text. When the combined opinion text is too large to inline, the response lists each variant as a retrievable section (opinion_<id>) while keeping the cheap cluster metadata — re-call with sections:[...] to pull specific variants in full. Obtain cluster IDs from courtlistener_search_opinions, courtlistener_lookup_citation, or docket results.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cluster_id": {
"description": "Opinion cluster ID — identifies a case decision and groups all opinion variants (majority, concurrence, dissent). Obtain from courtlistener_search_opinions, courtlistener_lookup_citation, or from docket results that link to opinions.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"sections": {
"description": "Opinion variant identifiers to retrieve in full, from a prior outline response (e.g. [\"opinion_12345\"]). Omit to return all variants, or an outline if they overflow the inline byte budget.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"cluster_id"
],
"type": "object"
},
"name": "courtlistener_get_opinion",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"cluster_id",
"case_name",
"case_name_full",
"court",
"court_id",
"date_filed",
"docket_id",
"docket_number",
"judges",
"citations",
"cite_count",
"precedential_status",
"syllabus",
"posture",
"kind"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"case_name": {
"description": "Short case name.",
"type": "string"
},
"case_name_full": {
"description": "Full case name with parties.",
"type": "string"
},
"citations": {
"description": "All known citation strings for this case.",
"items": {
"type": "string"
},
"type": "array"
},
"cite_count": {
"description": "Total number of citations from other opinions.",
"type": "number"
},
"cluster_id": {
"description": "Opinion cluster ID.",
"type": "number"
},
"court": {
"description": "Court display name.",
"type": "string"
},
"court_id": {
"description": "Court identifier.",
"type": "string"
},
"date_filed": {
"description": "Date the opinion was filed.",
"type": "string"
},
"docket_id": {
"description": "Associated docket ID.",
"type": "number"
},
"docket_number": {
"description": "Docket number.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: Cluster ID does not exist in CourtListener. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. `unknown_section`: A requested sections name matches no opinion variant in this cluster. Other values are possible when a failure originates below the handler.",
"examples": [
"not_found",
"rate_limited",
"unknown_section"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"judges": {
"description": "Judge names.",
"type": "string"
},
"kind": {
"description": "'full' returns the opinion variants (all, or a selected subset); 'outline' lists each variant as a retrievable section (opinion_<id>) when the opinions overflow the inline byte budget. Cluster metadata is present either way.",
"enum": [
"full",
"outline"
],
"type": "string"
},
"opinions": {
"description": "All opinion variants within this cluster. Present in full mode; omitted in outline mode — re-call with sections:[\"opinion_<id>\"] to retrieve specific variants.",
"items": {
"additionalProperties": false,
"description": "Individual opinion variant.",
"properties": {
"author_id": {
"description": "Person ID of the author; null if per curiam or unknown.",
"type": [
"number",
"null"
]
},
"cites": {
"description": "Opinion IDs this opinion cites.",
"items": {
"type": "number"
},
"type": "array"
},
"download_url": {
"description": "Direct download URL for the original opinion document; null if not available.",
"type": [
"string",
"null"
]
},
"html_text": {
"description": "Full opinion text as HTML, drawn from the best available variant (citation-linked when present); empty only when no HTML text is stored — use download_url then.",
"type": "string"
},
"id": {
"description": "Individual opinion ID.",
"type": "number"
},
"per_curiam": {
"description": "True if this is a per curiam opinion.",
"type": "boolean"
},
"plain_text": {
"description": "Plain text version of the opinion; may be empty.",
"type": "string"
},
"type": {
"description": "Raw CourtListener opinion-type code (e.g. \"030concurrence\"); the numeric prefix is a sort key, not part of the type. Empty when upstream recorded none.",
"type": "string"
},
"type_label": {
"description": "Opinion type expanded to the label courtlistener_search_opinions serves for the same variant: \"lead-opinion\", \"concurrence-opinion\", \"dissent\", \"combined-opinion\", etc. An unmapped code passes through as the code itself.",
"type": "string"
}
},
"required": [
"id",
"type",
"type_label",
"author_id",
"per_curiam",
"html_text",
"plain_text",
"cites",
"download_url"
],
"type": "object"
},
"type": "array"
},
"posture": {
"description": "Procedural posture (may be empty).",
"type": "string"
},
"precedential_status": {
"description": "Publication/precedential status.",
"type": "string"
},
"retrieval_notice": {
"description": "How to re-call the tool for specific opinion variants when the opinions overflow.",
"type": "string"
},
"sections": {
"description": "Retrievable opinion variants, largest first — pass names to `sections` on a re-call.",
"items": {
"additionalProperties": false,
"description": "A retrievable opinion variant (opinion_<id>) and its serialized byte size.",
"properties": {
"bytes": {
"description": "Serialized byte size of the section",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Section identifier — pass in `sections` to retrieve it",
"type": "string"
}
},
"required": [
"name",
"bytes"
],
"type": "object"
},
"type": "array"
},
"syllabus": {
"description": "Syllabus text (may be empty).",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Fetch the full detail record for a single oral argument audio recording by its ID (the audio_id from courtlistener_search_oral_arguments). Returns the case name, panel judge IDs, duration, MP3 download URL, linked docket, and the speech-to-text transcript when transcription has completed. A long transcript is withheld and listed as a retrievable section instead; re-call with sections:[\"transcript\"] to pull it. Every other field is present either way. The argument date is not on this record — it comes from the search result or the linked docket.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"description": "Audio recording ID — the audio_id field from a courtlistener_search_oral_arguments result.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"sections": {
"description": "Section identifiers to retrieve, from a prior outline response — [\"transcript\"] is the only one that adds anything, since every other field is returned regardless. A selection that omits \"transcript\" therefore returns the record without it. Omit this argument entirely for the whole record, or the record minus an oversized transcript.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "courtlistener_get_oral_argument",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"case_name": {
"description": "Case name.",
"type": "string"
},
"case_name_full": {
"description": "Full case name with parties.",
"type": "string"
},
"docket_id": {
"description": "Associated docket ID; 0 if not linked.",
"type": "number"
},
"download_url": {
"description": "Direct MP3 download URL; null if not available.",
"type": [
"string",
"null"
]
},
"duration_seconds": {
"description": "Recording duration in seconds.",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: Audio ID does not exist in CourtListener. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. `unknown_section`: A requested sections name is not a field of the oral argument record. Other values are possible when a failure originates below the handler.",
"examples": [
"not_found",
"rate_limited",
"unknown_section"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"has_transcript": {
"description": "True if a speech-to-text transcript is available.",
"type": "boolean"
},
"judges": {
"description": "Free-text judge names; often empty on this endpoint.",
"type": "string"
},
"kind": {
"description": "'full' carries the transcript inline; 'outline' withholds it and lists it as a retrievable section because it overflows the inline byte budget. Every other field of the record is present either way.",
"enum": [
"full",
"outline"
],
"type": "string"
},
"oral_argument_id": {
"description": "Audio recording ID.",
"type": "number"
},
"panel_ids": {
"description": "Person IDs of panel judges — pass to courtlistener_get_judge.",
"items": {
"type": "number"
},
"type": "array"
},
"retrieval_notice": {
"description": "How to re-call the tool for the transcript when it overflows the inline budget.",
"type": "string"
},
"sections": {
"description": "Sections withheld from this response — only ever `transcript`; pass its name to `sections` on a re-call. Absent when nothing was withheld.",
"items": {
"additionalProperties": false,
"description": "A withheld section of the record and its serialized byte size.",
"properties": {
"bytes": {
"description": "Serialized byte size of the section",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Section identifier — pass in `sections` to retrieve it",
"type": "string"
}
},
"required": [
"name",
"bytes"
],
"type": "object"
},
"type": "array"
},
"transcript": {
"description": "Speech-to-text transcript; empty string if transcription has not completed. The only field an outline response withholds — re-call with sections:[\"transcript\"] to retrieve it.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Fetch all parties and attorneys of record for a RECAP federal docket by docket ID. Returns each party's name, role (Plaintiff, Defendant, Petitioner, Respondent, etc.), and their attorneys with contact information, scoped to this docket. Costs two upstream requests per call (parties + attorney lookup) against a rate-limited free tier, and one more for each extra page of a large attorney roster. Obtain docket IDs from courtlistener_search_dockets or courtlistener_get_docket.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "Pagination cursor from a previous response's next_cursor field. Omit for the first page. This is an opaque token, not a page number — CourtListener cursor-paginates this endpoint, so a numeric value selects nothing and re-serves the first page.",
"type": "string"
},
"docket_id": {
"description": "Docket ID from a courtlistener_search_dockets or courtlistener_get_docket result's docket_id field.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"page_size": {
"default": 10,
"description": "Requested number of parties per page (1–10). CourtListener paginates this endpoint at a fixed size and does not honor the requested value, so a page can come back larger than asked for.",
"maximum": 10,
"minimum": 1,
"type": "integer"
}
},
"required": [
"docket_id"
],
"type": "object"
},
"name": "courtlistener_get_parties",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"docket_id",
"total_parties",
"next_cursor",
"parties"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"docket_id": {
"description": "Docket ID these parties belong to.",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: Docket ID does not exist in CourtListener or has no RECAP party data. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. Each call to this tool makes at least two upstream requests. Other values are possible when a failure originates below the handler.",
"examples": [
"not_found",
"rate_limited"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"next_cursor": {
"description": "Opaque pagination cursor for the next page — pass it back as the `cursor` argument; null when this is the last page.",
"type": [
"string",
"null"
]
},
"parties": {
"description": "Parties on this page.",
"items": {
"additionalProperties": false,
"description": "A party and their attorneys for this docket.",
"properties": {
"attorneys": {
"description": "Attorneys of record for this party on this docket.",
"items": {
"additionalProperties": false,
"description": "Attorney of record for this party.",
"properties": {
"attorney_id": {
"description": "Attorney record ID.",
"type": "number"
},
"contact_raw": {
"description": "Raw address/phone block from the attorney record. Empty string when unavailable.",
"type": "string"
},
"date_action": {
"description": "Date the attorney–party relationship ended; null while the attorney is still of record.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Attorney display name. Empty string when attorney detail is unavailable.",
"type": "string"
},
"role": {
"description": "role_code decoded to a label (e.g., \"Lead attorney\"). Codes 5–9 (\"Self-terminated\" through \"Disbarred\") mean the attorney is no longer of record. The stringified code when upstream sends a value outside the documented enum, \"Unrecorded\" when it sends none.",
"type": "string"
},
"role_code": {
"description": "Numeric attorney role code from the party–attorney relationship (1 = Attorney to be noticed, 2 = Lead attorney, 3 = Attorney in sealed group, 4 = Pro hac vice, 5 = Self-terminated, 6 = Terminated, 7 = Suspended, 8 = Inactive, 9 = Disbarred, 10 = Unknown); null when upstream recorded no code.",
"type": [
"number",
"null"
]
}
},
"required": [
"attorney_id",
"name",
"contact_raw",
"role_code",
"role",
"date_action"
],
"type": "object"
},
"type": "array"
},
"extra_info": {
"description": "Additional metadata from upstream (e.g., pro se status, date range).",
"type": "string"
},
"id": {
"description": "Party record ID.",
"type": "number"
},
"name": {
"description": "Party display name (e.g., \"Jane Doe\", \"Acme Corporation\").",
"type": "string"
},
"role": {
"description": "Role on this docket (e.g., \"Plaintiff\", \"Defendant\", \"Petitioner\", \"Respondent\"); null if not recorded.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"role",
"extra_info",
"attorneys"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total parties on this docket across all pages — this endpoint reports its count as a URL rather than a number, so the total is only derivable when the first page is also the last, and is absent for any list spanning more than one page.",
"type": "number"
},
"total_parties": {
"description": "Total parties on this docket across all pages; null when no total is derivable — CourtListener serves the count as a URL rather than a number here, so it is only known when the first page is also the last.",
"type": [
"number",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Resolve legal citations (e.g., \"410 U.S. 113\", \"93 S. Ct. 705\") to opinion cluster IDs and case metadata. Enables workflows that start from a known citation rather than a search query. CourtListener extracts every citation it finds in the submitted text, so passing a passage returns one entry per citation, each with its own resolution status — an unresolved or ambiguous citation is reported in the results, not raised as an error. Supports standard US reporter formats. Costs one request against CourtListener's per-citation quota, plus one ordinary request per distinct docket whose court is resolved — max_court_lookups bounds that second half (default 4, set 0 to skip court resolution entirely). CourtListener meters this endpoint by citations submitted rather than by call, so a long passage spends proportionally more of that quota. Requires authentication — uses the CourtListener /citation-lookup/ endpoint.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"citation": {
"description": "Text to extract citations from — normally a single citation (e.g., \"410 U.S. 113\", \"347 U.S. 483\", \"93 S. Ct. 705\"), but any passage works and every citation in it is resolved. Supports standard reporter formats. Up to 64000 characters, which is CourtListener's own ceiling; a longer passage is rejected here rather than spending a request to be refused upstream.",
"type": "string"
},
"max_court_lookups": {
"default": 4,
"description": "How many distinct dockets this call may spend a request on to resolve cluster courts. The lookup itself is metered separately by CourtListener (per citation submitted), so this budget is drawn entirely from the ordinary per-request allowance — published free tier 5/min, 50/hour, 125/day, varying by token tier. 0 skips court resolution and costs nothing beyond the lookup; 20 is the ceiling. Clusters past the budget come back with court null and court_resolution \"over_budget\".",
"maximum": 20,
"minimum": 0,
"type": "integer"
}
},
"required": [
"citation"
],
"type": "object"
},
"name": "courtlistener_lookup_citation",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"matches",
"queriedCitation"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: CourtListener could not parse any citation out of the submitted text. A citation that parses but matches nothing is a result with status 404, not this error. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. `empty_citation`: citation is empty or whitespace-only after trimming — no request is sent. `citation_too_long`: citation exceeds the 64000-character ceiling CourtListener accepts — no request is sent. Other values are possible when a failure originates below the handler.",
"examples": [
"not_found",
"rate_limited",
"empty_citation",
"citation_too_long"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"matches": {
"description": "One entry per citation CourtListener extracted from the input, in the order they appear.",
"items": {
"additionalProperties": false,
"description": "One citation found in the submitted text and everything it resolved to.",
"properties": {
"citation": {
"description": "The citation as CourtListener matched it in the submitted text.",
"type": "string"
},
"clusters": {
"description": "Cases this citation resolved to — empty when status is not 200 or 300, and more than one when status is 300.",
"items": {
"additionalProperties": false,
"description": "An opinion cluster this citation resolved to.",
"properties": {
"case_name": {
"description": "Case name; null if not recorded.",
"type": [
"string",
"null"
]
},
"citations": {
"description": "All known citation strings for this case.",
"items": {
"type": "string"
},
"type": "array"
},
"cite_count": {
"description": "Times other opinions cite this case — a rough authority weight. Null if not recorded.",
"type": [
"number",
"null"
]
},
"cluster_id": {
"description": "Opinion cluster ID — pass to courtlistener_get_opinion. Null when upstream sent no ID.",
"type": [
"number",
"null"
]
},
"court": {
"description": "Court display name. The citation-lookup payload carries no court, so this is resolved from the cluster's docket — one extra request each, capped by max_court_lookups (default 4 distinct dockets per call). Null when that lookup was skipped past the budget, failed, or the cluster has no docket_id; court_resolution says which. Pass docket_id to courtlistener_get_docket, or cluster_id to courtlistener_get_opinion, to resolve one.",
"type": [
"string",
"null"
]
},
"court_id": {
"description": "Court identifier for the `court` filter on the search tools (e.g. \"scotus\"); null under the same conditions as `court`.",
"type": [
"string",
"null"
]
},
"court_resolution": {
"description": "Why court/court_id are or are not populated: \"resolved\" the docket lookup returned a court; \"no_docket\" the cluster carries no docket_id, so nothing can be resolved; \"lookup_failed\" a request was spent on the docket and it yielded no court; \"over_budget\" no request was spent because max_court_lookups ran out or the walk stopped on a rate limit — raise max_court_lookups or fetch that docket directly.",
"enum": [
"resolved",
"no_docket",
"lookup_failed",
"over_budget"
],
"type": "string"
},
"date_filed": {
"description": "Date the opinion was filed; null if not recorded.",
"type": [
"string",
"null"
]
},
"docket_id": {
"description": "Linked docket — pass to courtlistener_get_docket. Null if not recorded.",
"type": [
"number",
"null"
]
},
"judges": {
"description": "Free-text judge names; null or empty if not recorded.",
"type": [
"string",
"null"
]
},
"precedential_status": {
"description": "Publication status (e.g. \"Published\", \"Unpublished\"); null if not recorded.",
"type": [
"string",
"null"
]
}
},
"required": [
"cluster_id",
"case_name",
"court",
"court_id",
"court_resolution",
"date_filed",
"docket_id",
"citations",
"cite_count",
"precedential_status",
"judges"
],
"type": "object"
},
"type": "array"
},
"error_message": {
"description": "CourtListener's explanation when status is not 200; empty string otherwise.",
"type": "string"
},
"normalized_citation": {
"description": "Canonical citation form used by CourtListener; null if not resolved.",
"type": [
"string",
"null"
]
},
"status": {
"description": "Resolution status for this citation alone: 200 one case, 300 several candidates, 400 unrecognized reporter, 404 no case found, 429 past the per-request citation cap. Not the status of the request, which succeeded.",
"type": "number"
},
"status_label": {
"description": "status decoded to a label.",
"type": "string"
}
},
"required": [
"citation",
"normalized_citation",
"status",
"status_label",
"error_message",
"clusters"
],
"type": "object"
},
"type": "array"
},
"notice": {
"description": "Caveats on this result: a recovery hint when no citation in the input resolved to a case, and counts of the clusters whose court went unresolved — split by whether the per-call docket budget ran out or an attempted lookup returned nothing, since only the first is worth retrying with a larger budget. Absent when none applies.",
"type": "string"
},
"queriedCitation": {
"description": "The citation string that was looked up.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "List courts with optional filtering by jurisdiction type, active/inactive status, and scraper coverage. Primarily used to discover court IDs for use in search and filter parameters across all other courtlistener tools. Defaults to the active bench — the courts CourtListener still scrapes; pass status:'inactive' for historical courts or status:'any' for every court. A bundled snapshot returns the complete list of matching court IDs without paging whenever the filtered set fits the response budget, which covers the default bench and every jurisdiction filter. Full court records — names, citation strings, scraper status — come live from CourtListener at a fixed 20 rows per page, so pull those only when a court ID alone is not enough.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"has_opinion_scraper": {
"description": "Filter to courts with active opinion scraping. Useful when planning search queries — courts without scrapers have sparse coverage.",
"type": "boolean"
},
"jurisdiction": {
"description": "Jurisdiction type — CourtListener's own court classification, one code per court: F=Federal Appellate, FD=Federal District, FB=Federal Bankruptcy, FBP=Federal Bankruptcy Panel, FS=Federal Special, S=State Supreme, SA=State Appellate, ST=State Trial, SS=State Special, SAG=State Attorney General, TRS=Tribal Supreme, TRA=Tribal Appellate, TRT=Tribal Trial, TRX=Tribal Special, TS=Territory Supreme, TA=Territory Appellate, TT=Territory Trial, TSP=Territory Special, MA=Military Appellate, MT=Military Trial, C=Committee, I=International. Omit to list all. SCOTUS and the numbered circuits are F; USITC and FISC are FS. Upstream's Testing code is not offered here: /courts/ excludes testing courts from every response, so a filter on it can only ever return nothing. Accepted but matching no court as of the 2026-07-30 snapshot: TSP, MT. Courts whose stored jurisdiction is not one of these codes (njcirctsussex, ohctapp1) are unreachable through this filter at any value — the value they store is not one the filter accepts. Pass those ids straight to the tool that needs them, or list with no jurisdiction filter.",
"enum": [
"F",
"FD",
"FB",
"FBP",
"FS",
"S",
"SA",
"ST",
"SS",
"SAG",
"TRS",
"TRA",
"TRT",
"TRX",
"TS",
"TA",
"TT",
"TSP",
"MA",
"MT",
"C",
"I"
],
"type": "string"
},
"page": {
"default": 1,
"description": "Page number (1-indexed). CourtListener serves /courts/ at a fixed 20 rows per page and ignores any requested page size, so the number of pages is the enrichment totalCount divided by 20 — there is no way to pull a larger page. Pass the next_cursor from a previous response here to walk them one call at a time.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"status": {
"default": "active",
"description": "Which bench to return. 'active' (default) returns only courts CourtListener currently scrapes; 'inactive' returns only the historical and defunct courts it no longer scrapes; 'any' returns both. The two filtered sets are disjoint, so 'any' is the only value that reaches the whole list — but reaching all of it means paging, one call per 20 courts, and the inactive bench is several times larger than the active one. Prefer the narrowest value that answers the question, and narrow with jurisdiction rather than paging the full list.",
"enum": [
"active",
"inactive",
"any"
],
"type": "string"
}
},
"type": "object"
},
"name": "courtlistener_lookup_courts",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"page",
"next_cursor",
"courts",
"all_matching_court_ids",
"all_matching_court_ids_complete",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"all_matching_court_ids": {
"description": "Every court id matching the same filters, from a snapshot of /courts/ bundled with this server (taken 2026-07-30) — the complete set, not just this page, and free of any request. Paging `courts` is only needed for the fields a court id alone does not carry (full_name, citation_string, scraper flags). Empty when more than 1000 courts match, since a prefix of the set would be indistinguishable from the whole of it — check all_matching_court_ids_complete before reading emptiness as \"no courts match\". A court added or retired upstream since the snapshot date appears in `courts` but may be missing here.",
"items": {
"type": "string"
},
"type": "array"
},
"all_matching_court_ids_complete": {
"description": "True when all_matching_court_ids holds every matching court id. False when more than 1000 courts match: the list is withheld whole rather than truncated, and the notice gives the count and how to narrow.",
"type": "boolean"
},
"courts": {
"description": "Matching courts on this page.",
"items": {
"additionalProperties": false,
"description": "Court record.",
"properties": {
"citation_string": {
"description": "Citation abbreviation (e.g., \"9th Cir.\", \"SCOTUS\").",
"type": "string"
},
"full_name": {
"description": "Full court name.",
"type": "string"
},
"has_opinion_scraper": {
"description": "True if CourtListener actively scrapes opinions from this court.",
"type": "boolean"
},
"has_oral_argument_scraper": {
"description": "True if CourtListener actively scrapes oral arguments from this court.",
"type": "boolean"
},
"id": {
"description": "Court identifier for use in search filter parameters.",
"type": "string"
},
"jurisdiction": {
"description": "Jurisdiction type code.",
"type": "string"
},
"short_name": {
"description": "Abbreviated court name.",
"type": "string"
}
},
"required": [
"id",
"full_name",
"short_name",
"citation_string",
"jurisdiction",
"has_opinion_scraper",
"has_oral_argument_scraper"
],
"type": "object"
},
"type": "array"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. Other values are possible when a failure originates below the handler.",
"examples": [
"rate_limited"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"next_cursor": {
"description": "Next page number to pass as the `page` argument (this list is page-paginated at a fixed 20 rows/page); null when this is the last page — a non-null value means the courts shown are a partial view of the filtered set.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Recovery hint when no courts match the applied filters.",
"type": "string"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"totalCount": {
"description": "Total courts returned.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Search RECAP federal court dockets. Query terms match case name, docket number, party, and attorney names; filters narrow by party name, court, and filing date. RECAP is a crowd-sourced mirror of PACER (the federal court filing system) — coverage varies by court and date. Returns docket metadata with the parties, attorneys, and firms of record, plus up to 3 sample document entries per docket. Use courtlistener_lookup_courts to find court IDs.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"court": {
"description": "Filter to a specific federal court ID (e.g., \"dnd\", \"cacd\", \"deb\" for Delaware Bankruptcy). Use courtlistener_lookup_courts to find court IDs.",
"type": "string"
},
"cursor": {
"description": "Pagination cursor from a previous response's next_cursor field.",
"type": "string"
},
"filed_after": {
"description": "Earliest case filing date (ISO 8601).",
"type": "string"
},
"filed_before": {
"description": "Latest case filing date (ISO 8601).",
"type": "string"
},
"page_size": {
"default": 20,
"description": "Number of results to request (default 20). CourtListener search enforces a minimum of 20 results per page regardless of the value passed — you will always receive at least 20 results.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"party_name": {
"description": "Filter to dockets listing a specific party by name — applied in addition to (AND with) the q query. More precise than including party names in q when the party name is known.",
"type": "string"
},
"q": {
"description": "Query terms matched against case name, docket number, party names, and attorney names. Example: \"Apple Inc patent infringement\".",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "courtlistener_search_dockets",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"next_cursor",
"coverage_note",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"coverage_note": {
"description": "Note about RECAP coverage limitations.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: CourtListener rejects caller-authored query or filter syntax with a recognized diagnostic. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. `empty_query`: q is empty or whitespace-only after trimming — no request is sent. `invalid_date`: filed_after or filed_before is not a valid ISO 8601 calendar date. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_query",
"rate_limited",
"empty_query",
"invalid_date"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"next_cursor": {
"description": "Pagination cursor for the next page; null when no more results.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Recovery hint when results are empty — echoes filters and suggests how to broaden.",
"type": "string"
},
"results": {
"description": "Matching docket records.",
"items": {
"additionalProperties": false,
"description": "Docket search result.",
"properties": {
"assigned_to": {
"description": "Assigned judge name; null if not recorded.",
"type": [
"string",
"null"
]
},
"attorneys": {
"description": "Attorney names of record on this docket; empty when none are recorded.",
"items": {
"type": "string"
},
"type": "array"
},
"case_name": {
"description": "Case name.",
"type": "string"
},
"case_name_full": {
"description": "Full case name with all parties; empty string when not recorded.",
"type": "string"
},
"cause": {
"description": "Legal cause of action.",
"type": "string"
},
"court": {
"description": "Court display name.",
"type": "string"
},
"court_id": {
"description": "Court identifier.",
"type": "string"
},
"date_filed": {
"description": "Date the case was filed.",
"type": "string"
},
"date_terminated": {
"description": "Date the case was terminated; null if still active.",
"type": [
"string",
"null"
]
},
"docket_id": {
"description": "Docket ID — pass to courtlistener_get_docket for full entry list.",
"type": "number"
},
"docket_number": {
"description": "Docket number.",
"type": "string"
},
"firms": {
"description": "Law firm names of record on this docket; empty when none are recorded.",
"items": {
"type": "string"
},
"type": "array"
},
"jurisdiction_type": {
"description": "Basis of federal jurisdiction (e.g. \"Federal Question\"); empty string when not recorded.",
"type": "string"
},
"jury_demand": {
"description": "Jury demand status.",
"type": "string"
},
"pacer_case_id": {
"description": "PACER case ID; null if not available in RECAP.",
"type": [
"string",
"null"
]
},
"parties": {
"description": "Party names listed in this docket.",
"items": {
"type": "string"
},
"type": "array"
},
"referred_to": {
"description": "Referred magistrate judge name; null if not recorded.",
"type": [
"string",
"null"
]
},
"sample_documents": {
"description": "Up to 3 sample filings matched on this docket — a search excerpt, not the docket's full filing list. Call courtlistener_get_docket for every entry.",
"items": {
"additionalProperties": false,
"description": "Sample document entry.",
"properties": {
"date_filed": {
"description": "Date the parent docket entry was filed; empty string when not recorded.",
"type": "string"
},
"description": {
"description": "Document description or title.",
"type": "string"
},
"document_number": {
"description": "PACER document number; null if not assigned.",
"type": [
"number",
"null"
]
},
"document_type": {
"description": "Document classification (e.g. \"PACER Document\", \"RECAP Document\"); empty string when not recorded.",
"type": "string"
},
"entry_number": {
"description": "Docket entry number this document belongs to; null if unnumbered.",
"type": [
"number",
"null"
]
},
"filepath_local": {
"description": "Fully-qualified RECAP storage URL (https://storage.courtlistener.com/...) for the document; null when no copy is stored.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Document ID.",
"type": "number"
},
"is_available": {
"description": "True if the document is available via RECAP without a PACER account.",
"type": "boolean"
},
"page_count": {
"description": "Page count; null if not recorded.",
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"description",
"date_filed",
"document_number",
"entry_number",
"document_type",
"page_count",
"filepath_local",
"is_available"
],
"type": "object"
},
"type": "array"
},
"suit_nature": {
"description": "Nature-of-suit label, usually prefixed with its PACER code (e.g. \"830 Patent\"); empty string when not recorded.",
"type": "string"
}
},
"required": [
"docket_id",
"case_name",
"case_name_full",
"court",
"court_id",
"date_filed",
"date_terminated",
"docket_number",
"pacer_case_id",
"assigned_to",
"referred_to",
"cause",
"jury_demand",
"suit_nature",
"jurisdiction_type",
"parties",
"attorneys",
"firms",
"sample_documents"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total matching dockets.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Search federal judicial financial disclosure filings — the annual reports judges file on investments, gifts, debts, outside positions, and income. Filter by judge (person ID from courtlistener_search_judges) and/or filing year; the year filter is applied to the fetched page only (CourtListener has no server-side year filter), so page through with cursor to reach a judge's filings for a year that fall on later pages. Returns per-filing metadata, category counts, itemized gifts, and a link to the source PDF. Line-item investments (often hundreds per filing, with coded values) are summarized as counts; the linked PDF carries the full itemization. Use this for judicial-ethics and recusal research after identifying a judge's person ID.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "Pagination cursor from a previous response's next_cursor field.",
"type": "string"
},
"judge_id": {
"description": "Person ID of the judge whose disclosures to return — obtain from courtlistener_search_judges (the person_id field). Omit to browse across all filers.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Number of filings to request (default 20). CourtListener enforces a minimum of 20 results per page regardless of the value passed — you will always receive at least 20 filings.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"year": {
"description": "Filing year to filter by (e.g., 2022). Applied client-side to the fetched page only — CourtListener rejects a server-side year param, so filings for this year on later pages are not included. When a page has no match for the year but more pages remain, next_cursor is returned; pass it as cursor to check the next page. Omit to return all years on the page.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"type": "object"
},
"name": "courtlistener_search_financial_disclosures",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"next_cursor"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. Other values are possible when a failure originates below the handler.",
"examples": [
"rate_limited"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"next_cursor": {
"description": "Pagination cursor for the next page; null when no more results.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Recovery hint when no filings are found — echoes filters and suggests next steps.",
"type": "string"
},
"results": {
"description": "Matching financial disclosure filings.",
"items": {
"additionalProperties": false,
"description": "A judicial financial disclosure filing.",
"properties": {
"counts": {
"additionalProperties": false,
"description": "Count of line items in each disclosure category.",
"properties": {
"agreements": {
"description": "Number of reported agreements.",
"type": "number"
},
"debts": {
"description": "Number of reported debts/liabilities.",
"type": "number"
},
"gifts": {
"description": "Number of reported gifts.",
"type": "number"
},
"investments": {
"description": "Number of reported investments.",
"type": "number"
},
"non_investment_incomes": {
"description": "Number of reported non-investment income sources.",
"type": "number"
},
"positions": {
"description": "Number of reported outside positions.",
"type": "number"
},
"reimbursements": {
"description": "Number of reported reimbursements.",
"type": "number"
},
"spouse_incomes": {
"description": "Number of reported spouse income sources.",
"type": "number"
}
},
"required": [
"investments",
"gifts",
"debts",
"positions",
"reimbursements",
"agreements",
"non_investment_incomes",
"spouse_incomes"
],
"type": "object"
},
"disclosure_id": {
"description": "Financial disclosure ID.",
"type": "number"
},
"gifts": {
"description": "Itemized gifts (the most ethics-relevant category; usually few).",
"items": {
"additionalProperties": false,
"description": "A reported gift.",
"properties": {
"description": {
"description": "What the gift was.",
"type": "string"
},
"source": {
"description": "Who provided the gift.",
"type": "string"
},
"value": {
"description": "Reported dollar value; empty if not stated.",
"type": "string"
}
},
"required": [
"description",
"source",
"value"
],
"type": "object"
},
"type": "array"
},
"has_been_extracted": {
"description": "True if line items were parsed from the PDF; counts are 0 when false.",
"type": "boolean"
},
"is_amended": {
"description": "True if this filing is an amendment.",
"type": "boolean"
},
"page_count": {
"description": "Page count of the source filing; null if not recorded.",
"type": [
"number",
"null"
]
},
"pdf_url": {
"description": "URL to the source disclosure PDF; null if unavailable.",
"type": [
"string",
"null"
]
},
"person_id": {
"description": "Person ID of the filer — pass to courtlistener_get_judge; null if absent.",
"type": [
"number",
"null"
]
},
"report_type": {
"description": "Report type (Nomination, Initial, Annual, Final, or Unknown).",
"type": "string"
},
"year": {
"description": "Filing year.",
"type": "number"
}
},
"required": [
"disclosure_id",
"person_id",
"year",
"report_type",
"page_count",
"has_been_extracted",
"is_amended",
"pdf_url",
"counts",
"gifts"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total matching disclosure filings — present only when the API reports a numeric count (this endpoint returns it as a URL by default, so it is usually absent).",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Search judge/person records by name, appointing president, court, political affiliation, or demographic. Returns biographical data, current position, and appointment summary. Use courtlistener_get_judge for full appointment history and education records.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"appointer": {
"description": "Filter by appointing president's last name (e.g., \"Obama\", \"Trump\", \"Biden\"). Matches against the appointer field in position records.",
"type": "string"
},
"court": {
"description": "Filter to judges who have held a position at this court (e.g., \"scotus\", \"ca9\"). Use court_id strings from courtlistener_lookup_courts.",
"type": "string"
},
"cursor": {
"description": "Pagination cursor from a previous response's next_cursor field.",
"type": "string"
},
"page_size": {
"default": 20,
"description": "Number of results to request (default 20). CourtListener search enforces a minimum of 20 results per page regardless of the value passed.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"political_affiliation": {
"description": "Filter by political affiliation: d=Democrat, r=Republican, i=Independent, l=Libertarian, g=Green Party, u=Unknown/unconfirmed. Based on party of the appointing president or election affiliation.",
"enum": [
"d",
"r",
"i",
"l",
"g",
"u"
],
"type": "string"
},
"q": {
"description": "Search query — judge name, court, city, or relevant keywords.",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "courtlistener_search_judges",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"next_cursor",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: CourtListener rejects caller-authored query or filter syntax with a recognized diagnostic. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. `empty_query`: q is empty or whitespace-only after trimming — no request is sent. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_query",
"rate_limited",
"empty_query"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"next_cursor": {
"description": "Pagination cursor for the next page; null when no more results.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Recovery hint when results are empty — echoes filters and suggests how to broaden.",
"type": "string"
},
"results": {
"description": "Matching judge records.",
"items": {
"additionalProperties": false,
"description": "Judge search result.",
"properties": {
"aba_rating": {
"description": "ABA qualification labels (e.g. \"Well Qualified\", \"Qualified\"), one per rating on record — not the rating codes.",
"items": {
"type": "string"
},
"type": "array"
},
"current_position": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"appointer": {
"description": "Name of the appointing president (e.g. \"Obama, Barack Hussein, II\"); null if elected or not recorded.",
"type": [
"string",
"null"
]
},
"court": {
"description": "Court full name; null for non-judicial positions.",
"type": [
"string",
"null"
]
},
"court_id": {
"description": "Court identifier for use in filter parameters; null for non-judicial positions.",
"type": [
"string",
"null"
]
},
"date_start": {
"description": "Date the position started; null if not recorded.",
"type": [
"string",
"null"
]
},
"date_termination": {
"description": "Date the position ended; null while the judge still holds it.",
"type": [
"string",
"null"
]
},
"job_title": {
"description": "Free-text title for non-judicial roles (e.g. \"Assistant district attorney\"); null for judicial positions.",
"type": [
"string",
"null"
]
},
"organization_name": {
"description": "Employer for non-judicial roles; null for judicial positions.",
"type": [
"string",
"null"
]
},
"position_type": {
"description": "Judicial position title (e.g. \"Judge\", \"Chief Judge\"); null for non-judicial positions — see job_title.",
"type": [
"string",
"null"
]
},
"selection_method": {
"description": "How the judge reached the position (e.g. \"Appointment (President)\", \"Election (Partisan)\"); null if not recorded.",
"type": [
"string",
"null"
]
},
"termination_reason": {
"description": "Why the position ended (e.g. \"Appointed to Other Judgeship\", \"Retirement\"); null while still serving.",
"type": [
"string",
"null"
]
}
},
"required": [
"court",
"court_id",
"position_type",
"job_title",
"organization_name",
"appointer",
"selection_method",
"date_start",
"date_termination",
"termination_reason"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "The position with no termination date, or — when several or none qualify — the one with the latest start date. Null when the record carries no positions. courtlistener_get_judge returns the full appointment history."
},
"dob": {
"description": "Date of birth; null if not recorded.",
"type": [
"string",
"null"
]
},
"dob_city": {
"description": "City of birth; null if not recorded.",
"type": [
"string",
"null"
]
},
"dob_state": {
"description": "State of birth; null if not recorded.",
"type": [
"string",
"null"
]
},
"gender": {
"description": "Gender.",
"type": "string"
},
"name": {
"description": "Full judge name.",
"type": "string"
},
"person_id": {
"description": "Person ID — pass to courtlistener_get_judge for full biography.",
"type": "number"
},
"political_affiliation": {
"description": "Party labels (e.g. \"Democratic\", \"Republican\"), one per recorded affiliation — not the single-letter codes the political_affiliation input filter takes.",
"items": {
"type": "string"
},
"type": "array"
},
"schools": {
"description": "Educational institutions attended.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"person_id",
"name",
"gender",
"dob",
"dob_city",
"dob_state",
"political_affiliation",
"aba_rating",
"schools",
"current_position"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total matching judge records.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Full-text search across 9M+ written US court opinions with field-level filtering. Returns opinion cluster summaries with case metadata, citations, matched text snippets, and the individual opinion variants filed in each case. Supports CourtListener field syntax (caseName:\"roe v wade\", court_id:scotus, judge:\"Alito\") and boolean operators (AND, OR, NOT). Use courtlistener_lookup_courts to find court IDs. CourtListener publishes free-tier limits of 5 req/min, 50/hr, 125/day; actual limits vary by token tier.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"court": {
"description": "Filter to a specific court by court ID (e.g., \"scotus\", \"ca9\", \"nyed\"). Use courtlistener_lookup_courts to find court IDs.",
"type": "string"
},
"cursor": {
"description": "Pagination cursor from a previous response's next_cursor field. Omit for the first page.",
"type": "string"
},
"filed_after": {
"description": "Earliest filing date (ISO 8601, e.g., \"2020-01-01\"). Narrows search to opinions filed on or after this date.",
"type": "string"
},
"filed_before": {
"description": "Latest filing date (ISO 8601). Narrows search to opinions filed before or on this date.",
"type": "string"
},
"order_by": {
"default": "score desc",
"description": "Result ordering. \"score desc\" (default) ranks by relevance. \"citeCount desc\" surfaces most-cited opinions first.",
"enum": [
"score desc",
"dateFiled desc",
"dateFiled asc",
"citeCount desc"
],
"type": "string"
},
"page_size": {
"default": 20,
"description": "Number of results to request (default 20). CourtListener search enforces a minimum of 20 results per page regardless of the value passed — you will always receive at least 20 results. Each search costs one request against the rate limit.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Full-text query. Supports field syntax (caseName:\"roe v wade\", court_id:scotus, judge:\"Alito\") and boolean operators (AND, OR, NOT). Use plain English for semantic-style queries or legal citations.",
"type": "string"
},
"status": {
"description": "Opinion publication status. \"Published\": precedential. \"Unpublished\": not citable as precedent in most jurisdictions. \"Errata\": corrections. \"Separate\": separate opinion filed outside main cluster. \"In-chambers\": single-justice order. \"Relating-to\": companion or related-case order. Omit to search all statuses.",
"enum": [
"Published",
"Unpublished",
"Errata",
"Separate",
"In-chambers",
"Relating-to",
"Unknown"
],
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "courtlistener_search_opinions",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"next_cursor",
"totalCount",
"effectiveQuery"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"effectiveQuery": {
"description": "Query terms sent to CourtListener.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: CourtListener rejects caller-authored query or filter syntax with a recognized diagnostic. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. `empty_query`: q is empty or whitespace-only after trimming — no request is sent. `invalid_date`: filed_after or filed_before is not a valid ISO 8601 calendar date. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_query",
"rate_limited",
"empty_query",
"invalid_date"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"next_cursor": {
"description": "Pagination cursor for the next page; null when no more results.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Recovery hint when results are empty — echoes filters and suggests how to broaden.",
"type": "string"
},
"results": {
"description": "Matching opinion cluster summaries.",
"items": {
"additionalProperties": false,
"description": "Opinion cluster summary.",
"properties": {
"case_name": {
"description": "Short case name (e.g., \"Roe v. Wade\").",
"type": "string"
},
"case_name_full": {
"description": "Full case name with parties.",
"type": "string"
},
"citations": {
"description": "Formatted citation strings (e.g., \"410 U.S. 113\").",
"items": {
"type": "string"
},
"type": "array"
},
"cite_count": {
"description": "Number of times this opinion has been cited by other opinions.",
"type": "number"
},
"cluster_id": {
"description": "Opinion cluster ID — pass to courtlistener_get_opinion or courtlistener_get_citations.",
"type": "number"
},
"court": {
"description": "Court display name.",
"type": "string"
},
"court_id": {
"description": "Court identifier for use in subsequent filter parameters.",
"type": "string"
},
"date_filed": {
"description": "Date the opinion was filed (YYYY-MM-DD).",
"type": "string"
},
"docket_id": {
"description": "Docket ID — pass to courtlistener_get_docket.",
"type": "number"
},
"docket_number": {
"description": "Docket number for this case.",
"type": "string"
},
"judges": {
"description": "Judge names associated with the opinion.",
"type": "string"
},
"opinions": {
"description": "Opinion variants filed in this case (majority, concurrence, dissent, per curiam). Empty when upstream returned none.",
"items": {
"additionalProperties": false,
"description": "One opinion variant within the cluster.",
"properties": {
"author_id": {
"description": "Person ID of the authoring judge — pass to courtlistener_get_judge; null when unattributed.",
"type": [
"number",
"null"
]
},
"cites": {
"description": "Opinion IDs this variant cites. These are opinion-level IDs, not cluster IDs — courtlistener_get_opinion and courtlistener_get_citations both take a cluster_id, so do not pass these values to them directly.",
"items": {
"type": "number"
},
"type": "array"
},
"download_url": {
"description": "URL of the originating court's copy; null when none was recorded. Often plain HTTP and prone to rot — prefer local_path.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Opinion ID for this variant — identifies one opinion within the cluster (the cluster itself is cluster_id).",
"type": "number"
},
"local_path": {
"description": "CourtListener-hosted copy of the source document (https://storage.courtlistener.com/...); null if not stored.",
"type": [
"string",
"null"
]
},
"per_curiam": {
"description": "True when the opinion was issued per curiam (by the court).",
"type": "boolean"
},
"type": {
"description": "Variant type as an expanded label (e.g. \"combined-opinion\", \"lead-opinion\", \"dissent\").",
"type": "string"
}
},
"required": [
"id",
"type",
"author_id",
"per_curiam",
"download_url",
"local_path",
"cites"
],
"type": "object"
},
"type": "array"
},
"snippet": {
"description": "Matched text excerpt, taken from the first entry in opinions[] that carries one; empty string when no variant has an excerpt. CourtListener does not mark which variant the search matched, so treat this as a relevance preview for the cluster, not as an excerpt attributable to a specific opinion — read opinions[] to attribute it.",
"type": "string"
},
"status": {
"description": "Publication status (Published, Unpublished, etc.).",
"type": "string"
}
},
"required": [
"cluster_id",
"case_name",
"case_name_full",
"court",
"court_id",
"date_filed",
"docket_number",
"docket_id",
"citations",
"cite_count",
"judges",
"status",
"snippet",
"opinions"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total matching opinions in the corpus.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Search appellate oral argument audio recordings — the largest public collection of oral argument audio. Returns recording metadata with two direct MP3 links per result (download_url at the originating court, local_path for CourtListener's durable copy), panel judge IDs, and transcript snippets where available. Panel judge IDs can be passed to courtlistener_get_judge for biographical context.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"argued_after": {
"description": "Earliest date the case was argued (ISO 8601) — filters by argument date, not publication date.",
"type": "string"
},
"argued_before": {
"description": "Latest date the case was argued (ISO 8601).",
"type": "string"
},
"court": {
"description": "Filter to a specific court (e.g., \"scotus\", \"ca9\").",
"type": "string"
},
"cursor": {
"description": "Pagination cursor from a previous response's next_cursor field.",
"type": "string"
},
"page_size": {
"default": 20,
"description": "Number of results to request (default 20). CourtListener search enforces a minimum of 20 results per page regardless of the value passed.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Query terms matched against case name and transcribed argument text (where available).",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "courtlistener_search_oral_arguments",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"next_cursor",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: CourtListener rejects caller-authored query or filter syntax with a recognized diagnostic. `rate_limited`: 429 from CourtListener, or no request slot opened within the wait budget. `empty_query`: q is empty or whitespace-only after trimming — no request is sent. `invalid_date`: argued_after or argued_before is not a valid ISO 8601 calendar date. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_query",
"rate_limited",
"empty_query",
"invalid_date"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"next_cursor": {
"description": "Pagination cursor for the next page; null when no more results.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Recovery hint when results are empty — echoes filters and suggests how to broaden.",
"type": "string"
},
"results": {
"description": "Matching oral argument recordings.",
"items": {
"additionalProperties": false,
"description": "Oral argument recording.",
"properties": {
"audio_id": {
"description": "Audio recording ID.",
"type": "number"
},
"case_name": {
"description": "Case name.",
"type": "string"
},
"court": {
"description": "Court display name.",
"type": "string"
},
"court_id": {
"description": "Court identifier.",
"type": "string"
},
"date_argued": {
"description": "Date the case was argued; null if not recorded.",
"type": [
"string",
"null"
]
},
"docket_id": {
"description": "Associated docket ID.",
"type": "number"
},
"docket_number": {
"description": "Docket number.",
"type": "string"
},
"download_url": {
"description": "MP3 URL at the originating court; null if not recorded. Often plain HTTP and prone to rot as courts reorganize — prefer local_path, CourtListener's durable copy.",
"type": [
"string",
"null"
]
},
"duration_seconds": {
"description": "Recording duration in seconds.",
"type": "number"
},
"judges": {
"description": "Judge names on the panel.",
"type": "string"
},
"local_path": {
"description": "CourtListener-hosted copy of the recording (https://storage.courtlistener.com/...); null if not stored.",
"type": [
"string",
"null"
]
},
"panel_ids": {
"description": "Person IDs of panel judges — pass to courtlistener_get_judge.",
"items": {
"type": "number"
},
"type": "array"
},
"snippet": {
"description": "Transcript excerpt where available; empty string if no transcript.",
"type": "string"
}
},
"required": [
"audio_id",
"case_name",
"court",
"court_id",
"date_argued",
"docket_id",
"docket_number",
"judges",
"panel_ids",
"duration_seconds",
"download_url",
"local_path",
"snippet"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total matching oral argument recordings.",
"type": "number"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:51100ed707eae7eca88a69fbd5c1af99638ee01a811daec16ef5b0f46d5bb379 | sha256sum