docketbird_search_documents
Read-onlyIdempotent
Search docket entries by title or description in a specific case to find filings labeled with a term.
Instructions
Find docket entries in ONE case whose title/description contains a term.
This matches docket-entry METADATA only (the title and description shown on
the docket sheet), not the text inside the filings. To search the full text
of filing bodies — across all courts or within one case — use
docketbird_fulltext_search instead.
When to use:
- User wants filings TITLED a certain way in a known case
(e.g. docket entries labeled "motion to dismiss")
- Narrowing down a docket sheet before download
Note: the upstream /documents endpoint has no pagination, so the entire
docket is always fetched and matched in memory; very large dockets can hit
DocketBird's own ~29s gateway timeout (a 504).
Args:
case_id: DocketBird case ID
search_term: Term to match against docket-entry titles/descriptions
page: Page number (starts at 1, default 1)
page_size: Results per page (default 20, max 50)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| case_id | Yes | ||
| page_size | No | ||
| search_term | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |