API v1.

Authentication

curl -H "Authorization: Bearer rcpt_xxx" \
  https://thereceipt.ng/api/v1/rankings

Free tier endpoints

• GET /api/v1/governors

  All governors with current fulfillment index.

• GET /api/v1/governors/:state

  One state's scorecard, governor, and promises.

• GET /api/v1/promises

  All promises. Filter with ?state=lagos.

• GET /api/v1/promises/:state/:slug

  One promise, full status history, linked receipts.

• GET /api/v1/receipts

  Approved evidence metadata (never the submitting handle).

• GET /api/v1/rankings

  Governors ranked by fulfillment index.

• GET /api/v1/fact-checks

  Published fact-checks. Empty until the Fact-Check Desk ships.

Org tier

Higher rate limits, bulk exports, webhooks on score changes. Granted by the editorial team, not self-serve. Get in touch.

• GET /api/v1/export/promises

  Bulk export, every promise, no pagination cap.

• POST /api/v1/webhooks

  Register an https:// endpoint for score_change events.

Rate limits

Free tier: 100 requests/hour. Org tier: 2,000 requests/hour. Rolling window, resets automatically.

Never exposed

Anything about a handle beyond public leaderboard aggregates, raw verdict records (only the public splits), moderation data, admin anything.

Changelog

• v1, initial release: governors, promises, receipts, rankings, fact-checks (stub).