Find Related Cases
find_related_casesFind all documents sharing the same case number and get a derived procedural timeline. Ideal for understanding the full scope of a legal case.
Instructions
Finds other documents sharing the same case number as the given case, plus a derived procedural timeline. No AI credits consumed. This is NOT similarity search, it only follows the shared case number; for conceptually similar cases use semantic_search_cases instead. Returns relatedDocuments (each with id, title, caseNumber, court, decisionDate, caseType, isCurrent), capped at 50, and timeline entries (date, status, statusLabel, documentId), where status is one of Case Initiated, Hearings / Orders, or Final Judgment. Only documents that have both a decision date and a stored PDF appear in the timeline. meta carries caseNumber, totalDocuments and timelineEvents.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Case identifier: either a 24 character MongoDB ObjectId hex string, or a case number string. Lookup order: the server first tries to parse this as an ObjectId; only if that parse fails does it fall back to looking up by case number. This means a syntactically valid but nonexistent ObjectId returns 404 without ever trying the case number path. |