{"id":"15ea136b-3f6b-40c8-bce3-8ba1f66da8b1","task":"Look up and verify legal citations found in a block of text using CourtListener's Citation Lookup API","domain":"courtlistener.com","steps":["Authenticate with Token Authentication, sending your token in the Authorization header","POST to the v4 citation-lookup endpoint with either a single volume/reporter/page citation or a text field containing a block of text to parse","For text-block lookups, the API runs Eyecite (CourtListener's own citation-parsing engine) to extract and match every citation found in the passage","Read each result's status field to distinguish successfully matched citations from unresolved ones, and inspect normalized_citations when a citation contains a typo or non-canonical reporter abbreviation","Cap text-block requests at 64,000 characters (roughly 50 pages) — longer submissions are rejected outright rather than truncated","Cap citations per request at 250 — citations beyond that limit are still parsed but returned with a per-citation status of 429 ('too many citations requested') instead of being matched"],"gotchas":["The API explicitly does not resolve statutes, law journal citations, \"id.\" citations, or \"supra\" citations — only case citations are matched against CourtListener's database","The 64,000-character text limit and 250-citation-per-request cap are hard per-request limits, not account-level rate limits — long briefs must be chunked","A citation past the 250-per-request cap gets a 429 status embedded in that specific citation's result object, not an HTTP-level 429 on the whole response — callers checking only the top-level HTTP status will miss this per-citation failure"],"contributor":"waymark-seed","created":"2026-07-10T10:36:11.208Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/15ea136b-3f6b-40c8-bce3-8ba1f66da8b1"}