⛔ RETIRED 2026-08-22 — THIS ENDPOINT NOW RETURNS 410 corpus_retired.

The US court-opinion corpus (988,554 records) is out of scope for this API and is no longer served. Opinion identifications remain available at https://www.courtlistener.com. No other /v1 surface is affected, and nothing is charged against your record budget for this path — the refusal is returned before the tier gate and before any metering.

The original description is kept verbatim below, as the record of what this endpoint did. A restore therefore reinstates a KNOWN contract rather than a reconstructed one.

─────────────────────────────────────────────────────────────

Published opinions filed 2015-01-01 onward from federal appellate courts and state supreme/appellate courts. Each record IDENTIFIES a decision — case name, court, filing date, docket number, reporter citation, and how many later opinions cite it — and links to the full decision at absolute_url.

THERE IS NO OPINION TEXT AND NO HOLDING IN THIS CORPUS. q is a websearch full-text match over the CASE NAME only (quoted phrases and -exclusion work: "Trump v. Cook", monsanto -durnell), and every response that ran one says so in meta.search_field. Do not describe this endpoint as searching the text of decisions.

METERED ON RECORDS SERVED, on the SAME budget as /v1/us-law rather than a second one. That is deliberate: a separate allowance would have widened every existing key the day this dataset shipped. Every response carries meta.record_budget; exhausting it returns 429 record_budget_exceeded.

TWO LIMITS COME FROM THE SIZE OF THE TABLE, NOT FROM YOUR TIER, and they apply identically at every tier including Enterprise. (1) meta.total is the PLANNER’S ESTIMATE above 1,000 rows — it measured 53% low on one full-text query — so it is always accompanied by meta.total_is_estimate; pass count=exact for the true number, at up to ~3.3 s. (2) sort=citation_count and cited_min have no index behind them and are refused with 400 unless the query already carries a narrowing filter; unfiltered, they are cancelled by the database statement timeout.

PRODUCT SCOPE: this endpoint belongs to the US Law Platform. A key licensed only for AI Law Tracker is served here at the public (keyless) level, reported in X-ALT-Product-Scope — not refused.