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.
- ✓ 5,000 API calls/month
- ✓ 60-day data lag
- ✓ JSON + CSV export
- ✓ All settlement fields
- ✓ Email support
- ✗ Real-time feeds
- ✗ Webhooks
- ✗ 5-year history
- ✓ 50,000 API calls/month
- ✓ Real-time feeds
- ✓ JSON + CSV export
- ✓ Webhooks (settlement events)
- ✓ 5-year settlement history
- ✓ Priority support + SLA
- ✓ Dedicated Slack channel
- ✗ Raw DB access
- ✓ 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
| Feature | Basic | Professional | Enterprise |
|---|---|---|---|
| Monthly API calls | 5,000 | 50,000 | Unlimited |
| Data lag | 60 days | Real-time | Real-time |
| JSON export | ✓ | ✓ | ✓ |
| CSV export | ✓ | ✓ | ✓ |
| Parquet / raw DB | — | — | ✓ |
| Webhooks | — | ✓ | ✓ |
| 5-year history | — | ✓ | ✓ |
| White-label feed | — | — | ✓ |
| Dedicated AM | — | — | ✓ |
| BAA / NDA | — | — | ✓ |
| Support | Priority + SLA | Dedicated |
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:
{
"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_.
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.
| Param | Type | Default | Description |
|---|---|---|---|
| page opt | integer | 1 | Page number |
| per_page opt | integer | 25 | Results per page (max 100) |
| category opt | string | — | Filter by category: Privacy, Data Breach, Financial, Employment… |
| min_payout opt | integer | — | Min estimated payout USD |
| deadline_before opt | date | — | YYYY-MM-DD |
| search opt | string | — | Full-text search on title, company, summary |
| sort_by opt | string | deadline | deadline, payout, created |
| Param | Type | Default | Description |
|---|---|---|---|
| days opt | integer | 7 | Look-back window (1–90 days) |
| Param | Type | Default | Description |
|---|---|---|---|
| days opt | integer | 30 | Look-ahead window (1–90 days) |
| Param | Type | Description |
|---|---|---|
| :id | string | Numeric ID or URL slug |
No parameters. Returns all categories sorted by open settlement count.
No parameters. Returns totals, expiring counts, payout averages, category breakdown.
| Param | Type | Description |
|---|---|---|
| q | string | Search query (min 2 chars) |
Response Format
Every response uses the same envelope structure. Rate limit headers are set on every response.
{
"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
| Tier | Calls/Month | Calls/Minute | Price |
|---|---|---|---|
| Basic | 5,000 | 60 | $499/mo |
| Professional | 50,000 | 300 | $1,499/mo |
| Enterprise | Unlimited | Custom | Custom |
Error Codes
| HTTP | Code | Meaning |
|---|---|---|
| 401 | missing_api_key | No API key provided |
| 401 | invalid_api_key | Key not found in system |
| 403 | account_inactive | Account suspended |
| 403 | tier_restricted | Feature not in your plan |
| 404 | not_found | Settlement not found |
| 429 | rate_limit_exceeded | Monthly or per-minute quota hit |
| 500 | server_error | Our 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.
Data Products
Beyond API access, SettlementRadar offers bespoke research, intelligence briefings, and bulk data licensing for organizations that need more than an API.
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
Contact Sales
For Professional, Enterprise, or data product inquiries — fill out the form below. We respond within 4 business hours.