Reference

API Documentation

CrownWatch provides a public REST API for searching officials, viewing violations, and verifying cryptographic proofs.

Endpoints

GET/api/v1/civic-registry/stats

Registry statistics (total reports, officials, agencies, jurisdictions)

GET/api/v1/civic-registry?search=&country=&badge=&page=

Search officials by name, employee ID, or country

GET/api/v1/civic-registry/agencies?search=&country=&type=&page=

Search agencies by name, country, or type

GET/api/v1/civic-registry/suggest?q=

Auto-suggest officials and agencies (min 2 chars)

GET/api/v1/civic-registry/:id

Get official profile with violations and stats

GET/api/v1/civic-registry/agencies/:id

Get agency profile with officials and violations

GET/api/v1/civic-registry/recent?limit=10

Recent violation filings

GET/api/v1/civic-registry/violation-types

List all violation categories and types

GET/api/v1/civic-registry/verify/:hash

Verify report hash against ledger and OTS

GET/api/v1/civic-registry/map/violations

Geo-located violations for map display

POST/api/v1/civic-registry/officials

POST/api/v1/civic-registry/agencies

POST/api/v1/civic-registry/violations

File a violation report ($5 donation required)

POST/api/v1/civic-registry/responses

File a response to a violation

POST/api/v1/civic-registry/donate

Initiate a donation

GET/api/v1/civic-registry/health

Health check

GET/api/v1/civic-registry/feed.xml

RSS feed of recent filings

Quick Start

Search for an Official

curl https://crownwatch.org/api/v1/civic-registry?search=trudeau

Get Registry Stats

curl https://crownwatch.org/api/v1/civic-registry/stats

Verify a Report Hash

curl https://crownwatch.org/api/v1/civic-registry/verify/SHA256_HASH

Embed

Embeddable Widget

Embed an official's trust badge on your website:

<iframe src="https://crownwatch.org/embed/OFFICIAL_ID" width="350" height="200" frameborder="0"></iframe>

Limits

Rate Limits

Read Endpoints: 60 req/min per IP
Write Endpoints: 10 req/min per IP
Suggest Endpoint: 30 req/min per IP

Rate-limited requests return HTTP 429. Contact us if you need higher limits for legitimate use.

Policy

Data Policy

All data served by the CrownWatch API is public. Reports, trust scores, and official profiles are freely accessible.

If you build something with this API, we'd love to hear about it: [email protected]