GET /v1/elections/summary/
List elections by cycle, office, state, and district.
Request
- Base URLhttps://api.open.fec.gov (the document declares no server; this is the origin it was published from)
- AuthAPI key in header X-Api-Key and API key in query parameter api_key and API key in query parameter api_key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
US state or territory where a candidate runs for office
Two-digit US House distirict of the office the candidate is running for. Presidential, Senate and House at-large candidates will have District 00.
Two-year election cycle in which a candidate runs for office. Calculated from Form 2. The cycle begins with an odd year and is named for its ending, even year. This cycle follows the traditional house election cycle and subdivides the presidential and Senate elections into comparable two-year blocks. To retrieve data for the entire four years of a presidential term or six years of a senatorial term, you will need the election_full flag.
Federal office candidate runs for: H, S or P
True indicates that full election period of a candidate. False indicates that two year election cycle.
API key for https://api.data.gov. Get one at https://api.data.gov/signup.
Response
Default response
Changes
No recorded changes to this operation across all 20 revisions of this API.