{"uid":"cap_h20NSgx32Z9VDSmokx1aR","slug":"2s-io-861dda81","name":"2s.io US Court Opinion Search","description":"Search US court opinions (SCOTUS, federal circuits, state appellate/supreme — ~9M opinions). Query by free-text (party names, keywords, docket #, citation). Filter by court slug (e.g., \"scotus\", \"ca9\", \"nysupct\"), filing date range, and order (relevance/dateFiled-desc/dateFiled-asc/citeCount-desc). Returns clusterId, caseName, court, year, docket, reporter citations, citationCount, snippet, canonical URL. Discovery-side complement to case-verify. Backed by CourtListener (Free Law Project); underlying opinions are public domain.","url":"https://2s.io/api/law/case-search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":500,"minLength":2},"court":{"type":"string"},"limit":{"type":"integer","default":10,"maximum":20,"minimum":1},"order":{"enum":["relevance","dateFiled-desc","dateFiled-asc","citeCount-desc"],"type":"string"},"filedAfter":{"type":"string"},"filedBefore":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"q":"artificial intelligence","limit":10,"order":"relevance"}}},"response":{"_truncated":true,"_originalSize":10987}},"exampleRequest":{"q":"artificial intelligence","limit":10,"order":"relevance"},"tags":["x402"],"displayCostAmount":"0.0036","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0036/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JJv-z-JbGZ9X_fodQ_kiR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search ~9 million US court opinions (SCOTUS, federal circuits, state appellate/supreme) by keyword, party name, citation, or docket number with court and date filters","exampleAgentPrompt":"Search court opinions for cases about 'qualified immunity' in the 9th Circuit filed after 2018-01-01, sorted by citation count — show me up to 10 results.","exampleUseCases":null,"resultDescription":"Returns a list of matching court opinion records, each with a clusterId, caseName, court identifier, year, docket number, reporter citations, citationCount, a text snippet from the opinion, and a canonical CourtListener URL. Up to 20 results per call.","failureModes":["Query string too short (< 2 chars) or too long (> 500 chars) returns 400 validation error","Invalid court slug pattern returns 400 error","Invalid date format for filedAfter/filedBefore returns 400 error","No matching opinions returns empty results array","Payment failure (x402) returns 402 before executing search","Rate limiting or upstream CourtListener unavailability returns 503"],"whenToPreferThis":"Use this endpoint when you need to discover or find court opinions by keyword, party name, citation, or docket number across a broad corpus of ~9M US opinions. Prefer over manual CourtListener browsing when building automated legal research pipelines. Complements a case-verify endpoint when you need discovery first, then verification. Best when you need structured metadata (citations, court, year, snippet) rather than full opinion text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:51:38.034Z","isFirstParty":false}