Skip to main content
Veteran-Owned Business Secured by Stripe Court-Verified Settlements Only Based in Troy, Michigan 494+ Claims Filed
REST API v1 · Live Data

SettlementRadar Data API

Power your fintech app, law firm portal, news site, or consumer platform with structured class-action settlement data. 1132+ active settlements, updated daily.

1132+ Active Settlements
24h Update Lag
REST JSON + CSV
99.9% Uptime
GET /api/v1/settlements?status=open&min_payout=100
// Response — 200 OK
{
  "success": true,
  "data": [
    {
      "id": 4821,
      "name": "Meta Pixel Healthcare Privacy Settlement",
      "company_name": "Meta / Facebook",
      "category": "Privacy",
      "payout_range_min": 50,
      "payout_range_max": 500,
      "deadline": "2026-09-12",
      "proof_required": false,
      "status": "open"
    }
  ],
  "meta": { "total": 1132, "page": 1, "per_page": 25 }
}

API Pricing 3 tiers

Basic is fully self-serve — get your API key in minutes. Professional and Enterprise are for higher-volume and mission-critical use cases; reply with your use case and we'll get back to you within 24 hours.

Basic
$499/mo
Self-serve · Cancel anytime
  • 5,000 API calls/month
  • 60-day data lag
  • JSON + CSV export
  • All settlement fields
  • Email support
  • Real-time feeds
  • Webhooks
  • 5-year history
Start with Basic →
Enterprise
Custom
Negotiated · Volume discounts
  • Unlimited API calls
  • Real-time + raw DB access
  • White-label data feed
  • Webhooks + streaming
  • Full historical DB
  • Dedicated account manager
  • BAA / NDA on request
  • 99.9% uptime SLA
Contact Sales →
Feature Basic Professional Enterprise
Monthly API calls5,00050,000Unlimited
Data lag60 daysReal-timeReal-time
JSON export
CSV export
Parquet / raw DB
Webhooks
5-year history
White-label feed
Dedicated AM
BAA / NDA
SupportEmailPriority + SLADedicated
Just exploring? Basic is self-serve — start today, cancel anytime. For Professional or Enterprise, contact us and we typically respond within 4 business hours.

Quick Start 5 min

Get settlement data into your app in under 5 minutes.

1. Get your API key — subscribe to Basic above, or contact us for Professional/Enterprise. Your key will arrive by email.

2. Make your first request

curl -X GET "https://settlementradar.com/api/v1/settlements?per_page=5" \
  -H "X-API-Key: sr_your_key_here"
// Node.js / browser fetch
const response = await fetch(
  'https://settlementradar.com/api/v1/settlements?per_page=5',
  { headers: { 'X-API-Key': 'sr_your_key_here' } }
);
const { data, meta } = await response.json();
console.log(`${meta.total} total settlements`);
import requests

API_KEY = "sr_your_key_here"
BASE_URL = "https://settlementradar.com/api/v1"

resp = requests.get(
    f"{BASE_URL}/settlements",
    headers={"X-API-Key": API_KEY},
    params={"per_page": 5}
)
data = resp.json()
for s in data["data"]:
    print(f"{s['name']} — deadline: {s['deadline']}")
require 'net/http'
require 'json'

uri = URI('https://settlementradar.com/api/v1/settlements?per_page=5')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = 'sr_your_key_here'

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
JSON.parse(res.body)['data'].each { |s| puts s['name'] }

3. You're in — the response looks like this:

✓ 200 OK
{
  "success": true,
  "data": [
    {
      "id": 4821,
      "slug": "meta-pixel-healthcare-privacy-2026",
      "name": "Meta Pixel Healthcare Privacy Settlement",
      "company_name": "Meta / Facebook",
      "category": "Privacy",
      "deadline": "2026-09-12",
      "payout_range_min": 50, "payout_range_max": 500,
      "proof_required": false,
      "filing_url": "https://metapixelclaimsettlement.com/file",
      "status": "open",
      "created_at": "2026-02-01T00:00:00Z"
    }
  ],
  "meta": {
    "request_id": "8f4e2c1a-9b3d-4e7f-a2c1",
    "timestamp": "2026-05-08T07:12:00Z",
    "total": 1132,
    "page": 1, "per_page": 5, "pages": 227,
    "rate_limit_remaining": 166,
    "rate_limit_reset": "2026-05-09T00:00:00Z"
  }
}

Authentication

All requests require an API key passed in the request header or query string. Keys begin with sr_.

Header (recommended): X-API-Key: sr_your_key_here
Query string: GET /api/v1/settlements?api_key=sr_your_key_here

Never commit API keys to public repos. If a key is compromised, email contact@settlementradar.com to rotate it immediately.

Endpoints

All endpoints under https://settlementradar.com/api/v1/ — JSON responses, CORS enabled.

GET /api/v1/settlements Paginated list with filters
ParamTypeDefaultDescription
page optinteger1Page number
per_page optinteger25Results per page (max 100)
category optstringFilter by category: Privacy, Data Breach, Financial, Employment…
min_payout optintegerMin estimated payout USD
deadline_before optdateYYYY-MM-DD
search optstringFull-text search on title, company, summary
sort_by optstringdeadlinedeadline, payout, created
GET /api/v1/settlements/new Settlements added in last N days
ParamTypeDefaultDescription
days optinteger7Look-back window (1–90 days)
GET /api/v1/settlements/expiring Settlements with deadlines in next N days
ParamTypeDefaultDescription
days optinteger30Look-ahead window (1–90 days)
GET /api/v1/settlements/:id Full settlement object by ID or slug
ParamTypeDescription
:idstringNumeric ID or URL slug
GET /api/v1/categories All categories with open counts + avg payouts

No parameters. Returns all categories sorted by open settlement count.

GET /api/v1/stats Platform-wide aggregate statistics

No parameters. Returns totals, expiring counts, payout averages, category breakdown.

GET /api/v1/settlements/search Full-text search (Professional+)
ParamTypeDescription
qstringSearch query (min 2 chars)

Response Format

Every response uses the same envelope structure. Rate limit headers are set on every response.

success envelope
{
  "success": true,
  "data": { /* object or array */ },
  "meta": {
    "request_id": "8f4e2c1a-...",
    "timestamp": "2026-05-08T07:00:00.000Z",
    "rate_limit_remaining": 166,
    "rate_limit_reset": "2026-05-09T00:00:00.000Z",
    // list endpoints also include:
    "total": 650, "page": 1, "per_page": 25, "pages": 26
  }
}

Rate Limits

TierCalls/MonthCalls/MinutePrice
Basic5,00060$499/mo
Professional50,000300$1,499/mo
EnterpriseUnlimitedCustomCustom
Monthly quotas reset on your billing anniversary. The Retry-After header tells you exactly how many seconds to wait after a rate limit hit.

Error Codes

HTTPCodeMeaning
401missing_api_keyNo API key provided
401invalid_api_keyKey not found in system
403account_inactiveAccount suspended
403tier_restrictedFeature not in your plan
404not_foundSettlement not found
429rate_limit_exceededMonthly or per-minute quota hit
500server_errorOur fault — email us

Who Uses This Data

Settlement data has high commercial value across several industries. Here's who's already using it and how.

⚖️
Law Firms
Match open settlements to existing clients. Identify cases where your firm can intervene. Track competitor case filings and payout trends.
💳
Fintech & Consumer Apps
Add a "money you might be owed" feature. Surface settlement opportunities based on purchase history, location, or account activity.
📰
Media & Newsrooms
Wire up a settlement tracker widget. Power auto-updating articles on the largest active class actions in your beat.
🔬
Academic Researchers
Analyze class-action trends, payout distributions, proof requirements, and industry frequency over time. Full history on Pro+.
🏢
Employers & HR
Power an employee financial wellness benefit. Push relevant settlement alerts to your workforce automatically via webhook.
🤖
AI & Agent Builders
Feed real-time settlement data into AI agents that monitor, alert, and even auto-file claims on behalf of consumers or businesses.

Data Products

Beyond API access, SettlementRadar offers bespoke research, intelligence briefings, and bulk data licensing for organizations that need more than an API.

Custom Report
$2,500–$8,000
Custom Research Report
Bespoke analysis of a specific category, company, or legal trend. PDF + data file + 30-min analyst briefing. Delivered in 5–10 business days.
Request a Report →
Intelligence Briefing
$4,800/yr
Quarterly Intelligence Briefing
4 in-depth market reports per year on settlement trends, payout patterns, emerging risk categories, and SettlementRadar proprietary data.
Subscribe →
Bulk Data License
$12,000/yr
Annual Bulk Data License
Full historical database export in CSV, Parquet, or JSON. Refreshed quarterly. No resale — internal use and research only. NDA available.
Contact for License →

Works With

Standard REST + JSON — works with any language or tool that can make HTTP requests.

Python Node.js Ruby cURL Go PHP Java R Zapier Make Retool Postman Jupyter

Zapier no-code example

Use SettlementRadar's API as a Zapier custom action: trigger on schedule → GET /api/v1/settlements/new?days=1send Slack/email/Sheets update. No code required.

Contact Sales

For Professional, Enterprise, or data product inquiries — fill out the form below. We respond within 4 business hours.

✓ Got it! We'll reply to your email within 4 business hours. Check your inbox for a confirmation.
Something went wrong — please email contact@settlementradar.com directly.
All systems operational Settlements updated recently Monitoring 691+ active cases