docketbird_search_cases
Read-onlyIdempotent
Search all indexed court cases by name or number to find DocketBird IDs, check litigation history, or verify if a company has been sued. Supports date and court filters.
Instructions
Search ALL cases in DocketBird's index by case name or case number.
Research scope: this covers every court and every case DocketBird knows
about — not just cases on your account (that's docketbird_list_cases).
Matching: case-number-shaped queries (e.g. '2:2017-bk-00112' or
'17-bk-112') match on filing year, case type, and terminating digits;
anything else matches against case names.
Date filters match in tiers: cases with an exact filing date match at day
precision; cases with only a known filing year match at year granularity;
cases with no known date are included unless exclude_unknown_dates=True.
When to use:
- Finding a case's DocketBird ID from a name or number
- Checking whether a company has been sued (pair with
docketbird_ask_litigation_graph for who represented whom)
Args:
query: Case name (e.g. 'Immedia Semiconductor') or case number
(e.g. '4:2022-cv-04775'). Max 500 chars.
court_id: Comma-separated court restriction; each entry may be a slug
('nysd'), an abbreviation ('S.D.N.Y.'), or a full court name.
filed_after: Only cases filed on/after this date (YYYY-MM-DD, inclusive).
filed_before: Only cases filed on/before this date (YYYY-MM-DD, inclusive).
exclude_unknown_dates: Drop cases whose filing date and year are both
unknown from date-filtered results (default False).
size: Results per page (default 25, max 50).
cursor: Pagination cursor from a previous response's next-page note.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | ||
| query | Yes | ||
| cursor | No | ||
| court_id | No | ||
| filed_after | No | ||
| filed_before | No | ||
| exclude_unknown_dates | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |