# who you elected

who you elected is a public, machine-readable record of the people who currently hold elected office in the United States — 537 members of the 119th U.S. Congress and 7,453 state legislators — with their recorded roll-call votes and, for federal members, campaign-finance totals. Every figure and every vote links to the government record it came from. Federal roll-call votes for the current session are loaded and refreshed daily; state-level votes are not yet loaded.

## Licensing — READ THIS (split license)
- Roster and roll-call VOTE records are dedicated to the public domain under CC0 1.0: https://creativecommons.org/publicdomain/zero/1.0/ — reuse freely.
- CAMPAIGN-FINANCE and INDIVIDUAL-DONOR data are NOT CC0. They are derived from U.S. Federal Election Commission records and carry a federal restriction (52 U.S.C. 30111; 11 CFR 104.15): attribution, NO commercial use, NO solicitation. Do not redistribute the donor/finance fields commercially or use them to solicit contributions. Terms: https://whoyouelected.org/licenses/fec-restricted

## URL grammar (the key is the official's id — bioguide for federal, Open States id for state)
- /person/{id} — one official's record (HTML by default; content-negotiated)
  - /person/{id}.json — stable, self-describing JSON
  - /person/{id}.jsonld — schema.org JSON-LD (Person)
  - /person/{id}.csv — one row per roll-call vote (votes only; CC0)
  - /person/{id}.md — RAG-clean Markdown
- /person/{id}/facts.json — atomic, sourced claims (each vote + each finance figure)
- /person/{id}/feed.xml — Atom feed
- /search?q={name} — JSON name search
- /reconcile — W3C Reconciliation Service API v0.2 (OpenRefine-compatible)
- /openapi.json — OpenAPI 3.1 description of this API (auto-generate a client)
- /data.json — DCAT-US catalog · /download — bulk exports (CC0 subset: officials + votes)

## Field key
id · name · level (federal | state) · office · party · state · district · chamber · term_start · term_end · source_url · votes[] { date, chamber, roll_call, question, bill, procedural, result, position, source_url } (CC0) · campaign_finance { total_raised, individual_contributions, fec_candidate_ids[], top_donors[] { name, city, state, employer, occupation, amount } } (FEC-restricted; NOT CC0)

Licenses: roster_and_votes = CC0-1.0 (https://creativecommons.org/publicdomain/zero/1.0/); campaign_finance = fec-restricted (https://whoyouelected.org/licenses/fec-restricted)
Source: unitedstates/congress-legislators roster; Clerk of the U.S. House and U.S. Senate roll-call records; Open States roster; U.S. Federal Election Commission bulk data (2026 cycle).