API
Programmatic access to civic data, normalized across thousands of jurisdictions.
Quick start
- Pick a plan and create an account.
- Generate an API key from your dashboard. The raw key is shown once — store it somewhere safe.
- Send the key as a Bearer token on every request:
curl -H "Authorization: Bearer slc_YOUR_KEY_HERE" \
https://api.subluceo.com/v1/documents?q=zoning&state=mn&limit=10Endpoints
High-level surface — full reference with request/response schemas is in the interactive docs (linked below). All endpoints return JSON.
/v1/documents
Search civic documents (agendas, minutes, resolutions, ordinances). Filter by state, jurisdiction, topic, date range, document type.
/v1/documents/{id}
Full document detail — extracted text, mentioned entities, classified topics, source URL.
/v1/meetings
Upcoming and historical meetings by jurisdiction, body, date.
/v1/jurisdictions
Registry of every tracked county, city, metro, and state with FIPS codes, parent relationships, and timezone metadata.
/v1/topics
Trending and historical topic activity. State-scoped, national, or topic-specific timeseries.
Quotas & rate limits
| Plan | Daily calls | Burst / second | Bulk export |
|---|---|---|---|
| County | 10,000 | 10 | — |
| National | 100,000 | 25 | CSV |
| Unlimited | — | 100 | CSV · Parquet |
See pricing for full plan details.
Interactive reference — coming soon
OpenAPI 3.1 spec with try-it-now console at /api/docs.
Until then, your dashboard has working examples for each endpoint
and our team responds to API questions on the
developer mailing list.