{"components":{"schemas":{"Matter":{"properties":{"attached_cases_count":{"nullable":true,"type":"integer"},"category":{"enum":["mass_tort","class_action","recall","regulatory","settlement"],"type":"string"},"eligibility_hint":{"nullable":true,"type":"string"},"headline":{"nullable":true,"type":"string"},"keywords":{"properties":{"brands":{"items":{"type":"string"},"type":"array"},"products":{"items":{"type":"string"},"type":"array"}},"type":"object"},"lifecycle":{"properties":{"claims_close_iso":{"nullable":true,"type":"string"},"claims_open_iso":{"nullable":true,"type":"string"},"first_seen_iso":{"type":"string"},"last_signal_iso":{"type":"string"},"mdl_filed_iso":{"nullable":true,"type":"string"},"narrative_generated_iso":{"nullable":true,"type":"string"},"settlement_announced_iso":{"nullable":true,"type":"string"}},"type":"object"},"links":{"properties":{"html":{"format":"uri","type":"string"},"primary":{"format":"uri","nullable":true,"type":"string"},"self":{"format":"uri","type":"string"}},"type":"object"},"matter_id":{"example":"mat_19e2a1f4f486e9","type":"string"},"name":{"type":"string"},"payout":{"properties":{"band":{"enum":["micro","small","medium","large","mass_tort"],"nullable":true,"type":"string"},"high_cents":{"nullable":true,"type":"integer"},"high_usd":{"nullable":true,"type":"integer"},"low_cents":{"nullable":true,"type":"integer"},"low_usd":{"nullable":true,"type":"integer"}},"type":"object"},"schema_version":{"example":1,"type":"integer"},"score":{"maximum":1,"minimum":0,"type":"number"},"score_30d":{"nullable":true,"type":"number"},"slug":{"example":"camp-lejeune","type":"string"},"status":{"enum":["rumored","emerging","litigated","settled","claims_open","closed"],"type":"string"},"subcategory":{"nullable":true,"type":"string"},"summary":{"nullable":true,"type":"string"},"velocity":{"nullable":true,"type":"number"}},"required":["matter_id","slug","name","category","status","score"],"type":"object"},"Signal":{"properties":{"first_seen_iso":{"type":"string"},"kind":{"example":"mdl_filing","type":"string"},"matter_id":{"description":"null until the entity resolver attaches the signal to a matter","nullable":true,"type":"string"},"provenance":{"additionalProperties":true,"description":"Source citation: {source_url, retrieved_at, author, confidence}","type":"object"},"resolution_confidence":{"nullable":true,"type":"number"},"resolved_by":{"enum":["auto","llm","human","pending"],"nullable":true,"type":"string"},"score":{"type":"number"},"signal_id":{"type":"string"},"source":{"example":"courtlistener_mdl","type":"string"},"source_id":{"type":"string"},"summary":{"nullable":true,"type":"string"},"title":{"nullable":true,"type":"string"},"url":{"format":"uri","nullable":true,"type":"string"}},"required":["signal_id","source","kind"],"type":"object"}}},"info":{"contact":{"email":"ops@getclaimscout.com"},"description":"Read-only, no-auth-required API for the claimscout matters data layer. Each `matter` is one tort or class-action issue (Camp Lejeune water contamination, Philips CPAP recall, hair relaxer uterine cancer MDL, etc.) with a structured narrative card, eligibility hint, payout band, and lifecycle status. Each `signal` is an event updating a matter (court filing, FDA recall, news article, social-media cluster).\n\nDesigned for AI agents. Use `/api/v1/matters` to enumerate the universe, then `/api/v1/matters/{slug}` to get full detail including attached claims-administrator cases (when claims are open) and recent signals.\n\nAll responses include an ETag for conditional GETs and stable JSON envelopes (`{data, pagination, meta}` for lists, `{data, meta}` for items, `{error, meta}` for errors).\n\nWrites (lead submission, watch subscription) require an API key \u2014 see /v1/openapi.json for the authed partner API.\n\nCompanion file: GET /llms.txt for a token-cheap agent quickstart.","license":{"name":"Proprietary \u2014 public read access permitted"},"title":"claimscout matters API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/health":{"get":{"responses":{"200":{"content":{"application/json":{}},"description":"ok"}},"summary":"Liveness + record counts.","tags":["system"]}},"/api/v1/matters":{"get":{"parameters":[{"in":"query","name":"category","schema":{"enum":["mass_tort","class_action","recall","regulatory","settlement"],"type":"string"}},{"in":"query","name":"status","schema":{"enum":["rumored","emerging","litigated","settled","claims_open","closed"],"type":"string"}},{"in":"query","name":"min_score","schema":{"type":"number"}},{"in":"query","name":"limit","schema":{"default":30,"maximum":100,"type":"integer"}},{"in":"query","name":"order_by","schema":{"default":"score","enum":["score","velocity","last_signal_iso","name"],"type":"string"}}],"responses":{"200":{"description":"list of matters"}},"summary":"List matters ordered by score (or velocity, last_signal_iso, name).","tags":["matters"]}},"/api/v1/matters/{slug}":{"get":{"parameters":[{"description":"e.g. 'camp-lejeune', 'philips-cpap'","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"matter detail"},"404":{"description":"no matter with that slug"}},"summary":"Get one matter (full card + attached cases + recent signals).","tags":["matters"]}},"/api/v1/signals":{"get":{"parameters":[{"in":"query","name":"matter_id","schema":{"type":"string"}},{"in":"query","name":"source","schema":{"type":"string"}},{"in":"query","name":"unresolved","schema":{"type":"boolean"}},{"in":"query","name":"limit","schema":{"default":30,"maximum":100,"type":"integer"}}],"responses":{"200":{"description":"list of signals"}},"summary":"Recent signals across all matters (or filtered).","tags":["signals"]}}},"servers":[{"description":"production","url":"https://getclaimscout.com"},{"description":"Fly direct","url":"https://claimscout.fly.dev"}],"tags":[{"description":"Upstream tort/class-action entities","name":"matters"},{"description":"Events updating a matter's score","name":"signals"},{"description":"Health + introspection","name":"system"}]}