# Democracy Works Elections API v1 (legacy)

**Canonical:** https://apis.io/apis/democracy-works/democracy-works-elections-v1-api/  
**Provider:** Democracy Works — https://apis.io/providers/democracy-works/  
**Base URL:** https://api.democracy.works  
**Documentation:** https://developers.democracy.works/api/v1

Democracy Works Elections API v1 (legacy) is one of 9 APIs that [Democracy Works](https://apis.io/providers/democracy-works/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Elections v1. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The first generation of the Democracy Works Elections API — 3 operations for upcoming elections and state election authorities. Still served at the unversioned base path and still documented (it is what the developer portal root returns), superseded by v2 in January 2024 but never marked deprecated and carrying no Sunset header. Uses a different auth header (Authorization: apikey) and returns application/edn error bodies.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/election-authorities/state-urls/{stateAbbreviation}` | State authority URLs |
| GET | `/election-authorities/states` | All state authorities (contact information) |
| GET | `/elections/upcoming` | Upcoming elections |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/democracy-works/refs/heads/main/openapi/democracy-works-elections-v1-api-openapi.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/democracy-works/refs/heads/main/overlays/democracy-works-elections-v1-api-overlay.yaml
- **Documentation** — https://developers.democracy.works/api/v1
- **APIReference** — https://developers.democracy.works/api/v1

## Other Democracy Works APIs (8)

- [Democracy Works Authorities API](https://apis.io/apis/democracy-works/democracy-works-authorities-api/)
- [Democracy Works Elections API](https://apis.io/apis/democracy-works/democracy-works-elections-api/)
- [Democracy Works Exports API](https://apis.io/apis/democracy-works/democracy-works-exports-api/)
- [Democracy Works Ballot Measures API](https://apis.io/apis/democracy-works/democracy-works-ballot-measures-api/)
- [Democracy Works Candidates API](https://apis.io/apis/democracy-works/democracy-works-candidates-api/)
- [Democracy Works Contests API](https://apis.io/apis/democracy-works/democracy-works-contests-api/)
- [Democracy Works Endorsements API](https://apis.io/apis/democracy-works/democracy-works-endorsements-api/)
- [Democracy Works Voting Locations API](https://apis.io/apis/democracy-works/democracy-works-voting-locations-api/)

## Tags

Elections v1

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/democracy-works/democracy-works-elections-v1-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/democracy-works/.