Class Action Hero API

Every open class-action settlement, as data. Free · No key · No signup

Endpoints

GEThttps://classactionhero.app/api/settlements.json

All open settlements currently accepting claims. Refreshed several times daily.

GEThttps://classactionhero.app/api/search-index.json

Lightweight search index (names + deadlines). For autocomplete and quick lookups.

GEThttps://classactionhero.app/api/story-leads.json

Story leads for journalists: 10 largest funds, 10 closing soonest, 10 no-proof-needed. Pre-computed daily.

GEThttps://classactionhero.app/api/feed.xml

RSS feed of settlements by upcoming deadline. Plug into your reader or newsroom Slack.

Schema

Each settlement object:

FieldTypeDescription
namestringSettlement name
deadlinestringFiling deadline (YYYY-MM-DD)
deadlineLabelstringHuman-readable deadline
fundstringTotal fund (e.g. "$9.5M")
fundNumnumberFund in dollars (numeric)
eligibilitystringWho qualifies, plain English
proofstringnone · notice · documents · unverified
statesarray/nullState codes if state-specific, null if nationwide
urlstringOfficial claim site
unverifiedbooleanTrue if not yet confirmed against official source

Example

curl https://classactionhero.app/api/settlements.json | \
  python3 -c "
import json,sys
data = json.load(sys.stdin)
closing = [s for s in data if s['deadline'] < '2026-11-01']
print(f'{len(closing)} settlements close before November')
for s in closing[:3]:
    print(f\"  {s['name']}: {s['fund']} by {s['deadlineLabel']}\")
"

Rules

Fair use: cache aggressively, don't hammer it. This is a free public dataset maintained by a small team — if you're building something big on it, say hi so we can keep it fast for everyone.

Class Action Hero · Free forever · Back to the tool

Terms of use

Free for any use — editorial, academic, commercial. No attribution required, though a link back is appreciated. Data is compiled from court-appointed settlement administrators and public records; verify critical facts against the official filing link before publishing. No warranty; provided as-is.

Why this API

Built for journalists and developers who need settlement data they can trust and sort.

Class Action Hero APITypical aggregator
Open cases tracked178, zero expiredVaries; often mixes open with closed
Numeric fund amounts100% structured (fundNum / perPersonMax)Usually text-only, not sortable
Per-person vs aggregate fundsDistinguished via fundTypeNot distinguished
Story leadsPre-computed (/api/story-leads.json)Not offered
RSS by deadlineYes (/api/feed.xml)Not offered
CSV cuts20 pre-built (/api/cuts/)Not offered
OpenAPI specYes (/api/openapi.json)Rare
Quality gateAutomated on every refresh: required fields, no expired deadlines, URL-or-explanationNot published
AuthNone. No key, no signup, no rate limit.Varies

Counts verified October 16, 2026. If you run a competing dataset and any of this is wrong, email [email protected] and we’ll correct it.