FOR DEVELOPERS

🔌 Build accountability
into everything.

Free. Open. No API key required. Pull constitutional scores into your app, your browser extension, your compliance tool — anything.

The Vision

We want constitutional scores everywhere. On every "I Agree" button. In every app store. In every compliance dashboard. The API is how we get there.

Right now, it's simple and open. No key needed. As we grow, we'll add webhooks, embeddable badges, historical scoring data, and real-time change detection — so when a company quietly updates their agreement, the world knows immediately.

Endpoints

GET /api/scores

Returns all scored companies with their overall score, grade, and review date.

Response
[
  {
    "slug": "bened",
    "name": "BENED",
    "score": 76,
    "grade": "B+",
    "lastReviewed": "2026-03-21"
  },
  {
    "slug": "apple",
    "name": "Apple",
    "score": 45,
    "grade": "D+",
    "lastReviewed": "2026-03-21"
  }
]
GET /api/scores/:slug

Returns full scorecard for a specific company — all category scores, criteria scores, notes, and findings.

Example
GET /api/scores/google
GET /api/rubric

Returns the full scoring rubric — all 10 categories, 36 criteria, weights, and descriptions.

GET /api/badge/:slug

Returns an embeddable SVG badge showing a company's score and grade. Drop it in your README, your website, anywhere.

Embed
<img src="https://conscore.bened.works/api/badge/bened" alt="Constitutional Score" />

Coming Soon

In Progress

🔔 Webhook Notifications

Get notified when a company's score changes. Subscribe to specific companies or score thresholds.

Planned

📊 Historical Scores

Track how scores change over time. See if companies are improving or getting worse.

Planned

🔑 API Keys & Rate Limits

For high-volume integrations. Free tier stays free forever. We'll never charge for accountability.

Planned

🔄 Agreement Pipeline

Auto-score new agreements as they're published. Integration with BENED's agreement registry. Real-time scoring visible to all users.

Future

🧩 Browser Extension

See a constitutional score before you click "I Agree." Powered by this API.

Future

📋 Submit for Scoring

Submit any agreement URL and get an automated preliminary score, with human review to follow.

Use It

curl
curl https://conscore.bened.works/api/scores
JavaScript
const res = await fetch('https://conscore.bened.works/api/scores');
const scores = await res.json();
scores.forEach(s => console.log(`${s.name}: ${s.score}/100 (${s.grade})`));

No authentication required. CORS enabled. Rate limit: 100 requests/minute. Need more? Talk to us.

📋 Grade 🏆 Rankings 📖 Handbook 🛡️ Mission