# Court Case & Docket Search

> Court Case & Docket Search is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-16).

Search federal and state court opinions and dockets by keywords, court, date range, case name, or docket number.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/find/record-court-cases?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/court-case-docket-search-48ccfa71
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4FYANaVj_FkyAapU2cPiD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability court-case-docket-search-48ccfa71 -d '<json body>'
```

Example prompt: Can you search for federal court opinions mentioning 'patent infringement' filed after 2022-01-01 in the Federal Circuit (cafc), and return up to 15 results?

## When to prefer this

Use this endpoint when you need to search legal court records — both published opinions and federal dockets — with flexible filtering by keyword, court, date, case name, or docket number. Prefer this over general web search when you need structured, authoritative legal case data rather than news articles or summaries.

## Known failure modes

- No results found for overly narrow query combinations (court + date range + keyword)
- Invalid court ID returns an error or empty result
- Query string outside 1–500 character limit is rejected
- Date format not in YYYY-MM-DD format causes a parsing error
- Limit outside 1–20 range is rejected
- Rate limiting or payment failure (x402) if USDC payment is not processed

## How this service works

Find court decisions and dockets by search words, court, date, case name or docket number.

## Output

Returns a paginated list of matching court opinions or docket entries, including case names, court identifiers, filing/decision dates, docket numbers, and links or references to the underlying documents — up to 20 results per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "kind": {
   "enum": [
    "opinions",
    "dockets"
   ],
   "type": "string",
   "description": "opinions searches published federal and state decisions; dockets searches federal cases and their filings. Default opinions. Defaults to `\"opinions\"`."
  },
  "court": {
   "type": "string",
   "description": "Only this court, by its short court ID, for example scotus, cafc or txed"
  },
  "limit": {
   "type": "integer",
   "description": "The most matches to return from the first page, from 1 to 20. Default 10. From 1 to 20. Defaults to `10`."
  },
  "query": {
   "type": "string",
   "description": "Search words, with quotes for an exact phrase and AND, OR or NOT between terms, for example patent. 1 to 500 characters."
  },
  "case_name": {
   "type": "string",
   "description": "Search within case names, for example Merck. 1 to 200 characters."
  },
  "filed_after": {
   "type": "string",
   "description": "Only cases filed on or after this date, YYYY-MM-DD; for opinions, this is the decision date"
  },
  "filed_before": {
   "type": "string",
   "description": "Only cases filed on or before this date, YYYY-MM-DD; for opinions, this is the decision date"
  },
  "docket_number": {
   "type": "string",
   "description": "Search within docket numbers, for example 23-1027. 1 to 100 characters."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/court-case-docket-search-48ccfa71/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)