Public API
Coming soon. A free, public REST API.
We’re polishing the schema and rate-limit story before we open it up. Same data you see on Sworn, machine-readable, no auth required, free under CC BY 4.0.
What ships at launch
The endpoints we’re building
REST + JSON, OpenAPI spec, edge-cached responses, no auth required. Rate-limiting will be polite — generous for civic-tech use, throttled for high-volume crawling.
- GET
/api/v1/countriesAll countries with current Sworn Score. - GET
/api/v1/countries?year=YYYYSnapshot at a specific year. - GET
/api/v1/countries/{ISO3}Country detail. - GET
/api/v1/countries/{ISO3}/metricsAll 19 metrics with history. - GET
/api/v1/countries/{ISO3}/promisesTracked promises with status. - GET
/api/v1/countries/{ISO3}/historyYear-by-year Sworn Scores. - GET
/api/v1/metricsFull metric catalog.
Early access
Need the API before launch?
Research orgs, civic-tech projects, and newsrooms can get a private key today. Send us a one-paragraph use-case and we’ll route it within a business day.