docketbird_ask_litigation_graph
Read-onlyIdempotent
Ask natural-language questions about relationships between parties, attorneys, law firms, judges, and courts in federal civil cases. Returns entity IDs and connections.
Instructions
Ask a natural-language question of DocketBird's litigation graph: parties, attorneys, law firms, judges, courts, and their connections.
This is the ONLY source of party/attorney/firm/judge relationships — the
docket endpoints do not return them. Examples: "What attorneys appeared
for Google in the Northern District of California?", "Every case where
Firm A appeared opposite Firm B", "What judges has Quinn Emanuel appeared
before?".
COVERAGE CEILING — read before trusting absence: the graph covers federal
civil cases active in DocketBird's data flows since July 2025 (roughly 30%
of federal civil cases). No criminal, bankruptcy, or state-court matters.
Zero records means "not in the graph," NEVER "no such cases exist" — do
not present an empty result as a finding that something doesn't exist.
Behavior:
- Slow: responses can take 10-25 seconds (an AI model interprets the
question, then queries the graph).
- Result shape varies with the question; entity IDs accompany names.
- At most 200 records per response; 'truncated' means more matches exist —
narrow the question to see the rest.
- Attorney email addresses are never included. This tool reports exactly
what the API returned — it never invents contact details.
Args:
question: The natural-language question (max 1000 characters).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| question | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |