# How to track federal court cases involving a specific company

> Step-by-step guide to looking up federal court dockets (CourtListener data) by company, by Nature of Suit code, or by specific docket ID — with canonical per-case detail pages.

## Steps

### Step 1: Find all cases where a company is a party

GET /api/v1/courts/by-party/{company_name} returns all federal court dockets (CourtListener / Free Law Project data) where the company appears as a party. Includes case name, court (txed, cacd, ilnd, etc.), date filed, Nature of Suit code, and assigned judge.

Endpoint: https://api.ai-analytics.org/api/v1/courts/by-party/Boston+Scientific

### Step 2: Filter by case type using Nature of Suit (NOS) code

The Federal Judicial Center NOS classification surfaces specific litigation types. Common high-signal codes: 850 (Securities), 830 (Patent), 410 (Antitrust), 365 (Personal Injury: Product Liability), 367 (Health Care/Pharma). GET /api/v1/courts/recent?nos=850 for all recent securities cases.

### Step 3: Drill into a specific case by docket ID

For each case in the result, follow to /case/{docket_id} for the canonical detail page with docket number, court, date filed, NOS classification, cause, judge, all parties, and the CourtListener source URL. Available as HTML, Markdown, or schema.org Legislation JSON-LD.

### Step 4: Watch for new high-signal filings via /today

The /today digest includes a "🏛️ Federal court filings — high-signal NOS codes" section showing the most recent securities, patent, antitrust, and product-liability filings. Each entry hyperlinks to its canonical /case page.

---

*[How-to guides](https://api.ai-analytics.org/how-to) · [AI Analytics](https://api.ai-analytics.org) · CC0 1.0*