No key is required during public beta. Cache responses, preserve source and coverage fields, and never represent the ballot-preview endpoint as an official complete ballot.
{
"api": "Election.org Public Data API v1",
"schema_version": "2026-08-25",
"generated_at": "…",
"data": { … },
"coverage": { … },
"sources": [ … ]
}Address-bearing endpoints return Cache-Control: private, no-store. Static public-record endpoints are cacheable and all API responses allow cross-origin GET requests.
/api/v1/address?address=90068Geography plus the complete currently sourced office stack.
Read live response →Raw JSON ↗/api/v1/representatives?address=90068Current holders and explicit office shells grouped by level.
Read live response →Raw JSON ↗/api/v1/districts?address=90068Congressional, state legislative, county, locality, and school GEOIDs.
Read live response →Raw JSON ↗/api/v1/countries?code=INPermanent G20 sovereign-country IDs, sourced electoral-management models, official institutions, and explicit international coverage gaps.
Read live response →Raw JSON ↗/api/v1/civic-systems?country=CNOfficial-source indirect-election and appointment paths, with explicit no-popular-result boundaries.
Read live response →Raw JSON ↗/api/v1/international-results?country=TH&year=2023&record_type=party&party=Move%20ForwardAuthoritative national-result adapters across 37 countries, with source-specific votes, seats, candidate records, and explicit limits kept separate.
Read live response →Raw JSON ↗/api/v1/ballots?address=90068An explicitly incomplete federal filing-record research preview.
Read live response →Raw JSON ↗/api/v1/elections?state=CAFEC-published 2026 congressional dates.
Read live response →Raw JSON ↗/api/v1/alerts?address=90068Address-resolved sourced dates, a privacy-preserving state calendar subscription, official voter actions, and explicit alert-coverage limits.
Read live response →Raw JSON ↗/api/v1/contests?state=CA&office=H&district=30Permanent 2026 U.S. House and Senate contest records with equal candidate fields, dates, source links, and no inferred ballot qualification.
Read live response →Raw JSON ↗/api/v1/datasetsVersioned bulk-download metadata, row counts, citations, source links, and coverage limits.
Read live response →Raw JSON ↗/api/v1/charts/democrat-republican-independent-identification-1988-2025A complete chart definition, plotted values, methodology, caveats, and source records for a permanent Election.org visualization.
Read live response →Raw JSON ↗/api/v1/downloads/federal-contests-2026.csvAll 478 permanent 2026 U.S. House and Senate FEC filing-field entities.
Download live response ↓/api/v1/downloads/federal-candidates-2026.csvAll 2,767 identity-complete, indexable federal candidate filing records connected to permanent contests.
Download live response ↓/api/v1/downloads/federal-results-2020.csvAll 2,994 FEC-published candidate result records with certified-stage and calculation labels.
Download live response ↓/api/v1/downloads/federal-results-2024.csvAll 1,300 House Clerk-published candidate result records with official-source and calculation labels.
Download live response ↓/api/v1/downloads/federal-results-2022.csvAll 3,098 FEC-published candidate result records with certified-stage and calculation labels.
Download live response ↓/api/v1/election-administration?state=CAEAC/NCSL state authority, local-administrator structure, official links, and policy summaries.
Read live response →Raw JSON ↗/api/v1/election-rules?state=CAState voting rules in source language, current linked ballot layers, and uncovered rule fields.
Read live response →Raw JSON ↗/api/v1/ballot-measures?level=local&locality=los-angelesOfficial California statewide propositions or all eight Los Angeles City measures, including neutral Yes/No meanings, source fingerprints, draft status, and visible source anomalies.
Read live response →Raw JSON ↗/api/v1/judges?state=CA&county=Los%20AngelesAll official California Supreme Court and county-mapped Court of Appeal questions, with exact ballot text and visible data gaps.
Read live response →Raw JSON ↗/api/v1/judicial-officials?state=CA&district=FirstCalifornia Supreme Court and Court of Appeal roster records with court membership, source-reported roles, explicit service-note status, and separate official ballot connections.
Read live response →Raw JSON ↗/api/v1/elections/calendar.ics?state=CAiCalendar feed of sourced 2026 federal dates with one-day reminders.
Download live response ↓/api/v1/offices?state=CA&level=statePermanent office records across current live source layers.
Read live response →Raw JSON ↗/api/v1/people?q=nancy%20pelosiPermanent federal and state public-person IDs with current roles, federal term history, exact external identifiers, and explicit identity and coverage boundaries.
Read live response →Raw JSON ↗/api/v1/local-adapters?state=NYOfficial local-roster sources, fail-closed validation rules, portrait counts, permanent directories, and explicit national coverage limits.
Read live response →Raw JSON ↗/api/v1/local-candidates?locality=san-diegoSource-backed 2026 local candidate layers for Los Angeles and San Diego. San Diego includes all eight official nominees, ballot order, occupational designations, candidate-submitted portraits and materials, disclosure links, SHA-256 fingerprints, and explicit source boundaries.
Read live response →Raw JSON ↗/api/v1/local-candidate-positions?contest=mayorExact campaign-published headings for all eight Los Angeles finalists, normalized into equal-topic contest comparisons with source fingerprints, retrieval dates, explicit gaps, and no Election.org score.
Read live response →Raw JSON ↗/api/v1/local-candidate-media?contest=mayorSourced debate events, public full-recording coverage, neutral topic timestamps, separate City Clerk candidate videos and transcripts, and explicit candidate or contest media gaps.
Read live response →Raw JSON ↗/api/v1/local-position-history?contest=mayorExact current campaign statements connected to archived and live observations, with archive time treated only as observed-by evidence and no generated flip-flop or consistency label.
Read live response →Raw JSON ↗/api/v1/local-promises?person=karen-ruth-bassPrecise campaign commitments connected to dated public actions and official measures, with source fingerprints, explicit reporting boundaries, and no kept-or-broken grade.
Read live response →Raw JSON ↗/api/v1/local-candidate-backgrounds?contest=mayorThe same eight sourced CV fields for all eight Los Angeles finalists, separating certified ballot designations from exact campaign biography excerpts and showing every gap.
Read live response →Raw JSON ↗/api/v1/local-candidate-endorsements?contest=mayorAll current campaign-reported endorsement records for the certified Los Angeles field, preserving source order and campaign labels while explicitly forbidding count-based rankings.
Read live response →Raw JSON ↗/api/v1/office-guides?slug=state-governorSource-backed explanations of what public offices can do, cannot do alone, commonly control, and where exact authority varies.
Read live response →Raw JSON ↗/api/v1/authority-topics?q=zoningSearch civic problems and return the multi-institution authority chain, boundaries, first steps, and official sources.
Read live response →Raw JSON ↗/api/v1/candidacy-opportunities?locality=los-angelesAddress-matched office records, federal constitutional minimums, and official filing sources—plus the complete 14-office Los Angeles 2026 filing adapter when the locality matches. Never a legal eligibility determination.
Read live response →Raw JSON ↗/api/v1/candidates?state=CA&office=H&district=30Identity-complete FEC candidate filing records.
Read live response →Raw JSON ↗/api/v1/candidate-filings?state=CA&office=HFederal candidate first filing dates recorded by the FEC, with raw source status fields and visible Census apportionment anomaly checks.
Read live response →Raw JSON ↗/api/v1/candidate-profiles?candidate_id=H4CA30149Source-by-field CV, positions, attributed endorsements, questionnaires, and official ballot records.
Read live response →Raw JSON ↗/api/v1/questionnaires?candidate_id=H4CA30149The same eight questions for every connected candidate, with verified-response and recorded-invitation status, source boundaries, and no score or inferred refusal.
Read live response →Raw JSON ↗/api/v1/candidate-compare?a=H4CA30149&b=H6CA30243Equal-schema comparison for two candidates in the same race, with no Election.org score.
Read live response →Raw JSON ↗/api/v1/committees?q=leadership%20pacFederal committee registration and summary records.
Read live response →Raw JSON ↗/api/v1/finance?candidate_id=H6AK01092Candidate totals with direct, coordinated, support, and oppose categories separated.
Read live response →Raw JSON ↗/api/v1/vendors?committee_id=C00946012Organization payees and spending categories from amendment-normalized FEC operating expenditures; individual payees are excluded.
Read live response →Raw JSON ↗/api/v1/state-finance?state=WAOfficial disclosure agencies plus live California, New York, Washington, and Colorado contribution, expenditure, filer, and privacy-safe entity aggregates—with jurisdiction-specific correction semantics and every remaining gap explicit.
Read live response →Raw JSON ↗/api/v1/financial-disclosures?q=pelosi&year=2026Official 2024–2026 House Clerk filing-index records, including direct PTR PDFs, exact source codes, ZIP fingerprints, and explicit transaction and interpretation boundaries.
Read live response →Raw JSON ↗/api/v1/stock-trades?q=pelosi&direction=purchaseWhole-document-validated House PTR transaction rows with filer, asset, source ticker, direction, dates, value label, owner code, filing status, PDF page, fingerprint, and visible image-only exclusions.
Read live response →Raw JSON ↗/api/v1/political-ads?q=direct%20mail&position=supportCurrent FEC independent-expenditure source rows with sponsor, candidate, filer-reported position, amount, purpose, payee, dates, source image, and an explicit filing-versus-ad-creative boundary.
Read live response →Raw JSON ↗/api/v1/governments?state=CA&category=special_district&q=fireOfficial 2025 Census government-unit, school-system, and public-pension records; matched California counties and incorporated places include the source-reported 2026 local roster with per-role selection method left unstated.
Read live response →Raw JSON ↗/api/v1/results?year=2022&state=CA&office=H&district=30Official historical federal results, candidate vote totals, percentages, runoffs, ranked-choice rounds, and clearly labeled calculations.
Read live response →Raw JSON ↗/api/v1/presidential-results?year=2024&state=CAOfficial 2024 presidential popular-vote and electoral-vote totals compiled by the FEC from state election offices, with candidate and state filters and no implied House or Senate coverage.
Read live response →Raw JSON ↗Keep the returned source and coverage context near downstream claims. FEC registration and filing data is not proof of ballot qualification. A ZIP is a postal geography and its center can fall in a different political district than another address in the same ZIP.
Build a responsive, source-bounded election card for any permanent 2026 federal race. No key, account, or JavaScript integration is required.
Open the newsroom widget builder →The public beta stays open. Organizations can partner with Election.org for higher-volume feeds, versioned snapshots, change alerts, uptime commitments, managed embeds, and integration support.
See professional and institutional options →