{"openapi":"3.1.0","info":{"title":"Missing Check Public API","version":"1.0.0","description":"Free public REST API for missingcheck.com class-action settlement data. Free tier — non-commercial; attribution required.","contact":{"email":"hello@missingcheck.com"}},"servers":[{"url":"https://missingcheck.com"}],"paths":{"/api/settlements":{"get":{"summary":"List live settlements","parameters":[{"name":"state","in":"query","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"parent_company","in":"query","schema":{"type":"string"}},{"name":"deadline_after","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"List of settlements","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementListEnvelope"}}}}}}},"/api/settlements/{id}":{"get":{"summary":"Get a settlement by UUID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Settlement","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Settlement"}}}},"404":{"description":"Not found"}}}},"/api/settlements/by-slug/{slug}":{"get":{"summary":"Get a settlement by slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Settlement","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Settlement"}}}},"404":{"description":"Not found"}}}},"/api/companies/{slug}":{"get":{"summary":"List settlements by parent company","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"List"},"404":{"description":"Not found"}}}},"/api/lookup":{"get":{"summary":"Reverse search by company / defendant / parent","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":80}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"Matches"}}}},"/data/settlements.json":{"get":{"summary":"Full dump (JSON). Rate-limited 10/min/IP.","responses":{"200":{"description":"Array of Settlement"}}}},"/data/settlements.csv":{"get":{"summary":"Full dump (CSV). Rate-limited 10/min/IP.","responses":{"200":{"description":"CSV"}}}}},"components":{"schemas":{"Settlement":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"defendant":{"type":"string","nullable":true},"parent_company":{"type":"string","nullable":true},"category":{"type":"string"},"court_docket":{"type":"string","nullable":true},"admin_url":{"type":"string","nullable":true},"official_url":{"type":"string","nullable":true},"deadline":{"type":"string","format":"date-time","nullable":true},"published_at":{"type":"string","format":"date-time","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time","nullable":true},"status":{"type":"string","enum":["live"]},"states":{"type":"array","items":{"type":"string"},"nullable":true},"eligibility":{"type":"object"},"requirements":{"type":"array","items":{"type":"string"}},"content":{"type":"object"},"fund_size":{"type":"string","nullable":true},"payout_min":{"type":"string","nullable":true},"payout_max":{"type":"string","nullable":true}}},"SettlementListEnvelope":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Settlement"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"_meta":{"type":"object","properties":{"attribution":{"type":"string"},"license":{"type":"string"},"docs":{"type":"string","format":"uri"}}}}}}}}