Versioning and changelog
The REST API is versioned in the path (/api/v1). Within v1 we add endpoints, parameters, and fields, but we don't remove or rename them or change what they mean. If a breaking change is ever needed it ships as a new version, announced here first while v1 keeps working. GraphQL fields are retired with @deprecated before they go away.
The older unversioned endpoints (/api/alderpersons, /api/votes, /api/matters, ...) still work with a key, but use /api/v1 for new work.
2026-10-27
- Campaign committees: each Chicago aldermanic candidate's committee with its Statement of Organization details and officers, and every document it filed with the State Board of Elections (report type, period, filed date, amendment) and a link to each one.
2026-10-08 (stances)
- API v2: your team's stance on one bill (
GET/PUT/DELETE /team/legislation/{record}/stance, with its history) and its target list for that bill (/team/legislation/{record}/targets). The stance is the same one the dashboard's Legislation page and/team/positionsshow. - Every v2 write (
PUT,PATCHandDELETEtoo, not onlyPOST) takesIdempotency-Key. A team may hold up to 100 positions (was 20).
2026-10-08 (later)
- API v2 writes: your follows and your team's follows, notes, positions and dashboards, with
.writescopes andIdempotency-Key. - OAuth apps ask for scopes; tokens carry them (and the team). Keys can have allowed IPs (CIDR) and be renamed or re-dated.
2026-10-08
- API v2 (read-only): public data plus your follows and your team's follows, notes, positions and dashboards, with its own OpenAPI document.
- Scoped API keys, personal or for a team, in the dashboard under Settings → API keys. Existing keys keep working.
2026-10-07
- Track legislation by stage: every matter this term by lifecycle stage, updated hourly.
- Member history: daily snapshots and quarterly campaign reports.
- Timeline, entities, and the relationship graph.
- New developer docs with an endpoint page and playground for every endpoint.
2026-10-06
- GraphQL at
/api/graphql, and thegraphqlMCP tool. - Campaign money and lobbying endpoints.
- API v1 with free accounts, API keys, OAuth 2.1, and agent registration; MCP server and A2A agent.