GET /v1/candidate/{candidate_id}/history/
Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to know more about a candidate's previous races.
This information is organized by candidate_id, so it won't help you find a candidate who ran for different offices over time; candidates get a new ID for each office.
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.
Path parameters
A unique identifier assigned to each candidate registered with the FEC. If a person runs for several offices, that person will have separate candidate IDs for each office. First character indicates office - [P]residential, [H]ouse, [S]enate]. Second character is the last digit of the two-year period the ID was created. Third and fourth is the candidate state. Presidential IDs don't have state. Fifth and sixth is the district when the candidate first ran. This does not change if the candidate/member's district changes during re-districting. Presidential IDs don't have districts. The rest is sequence.
Query parameters
For paginating through results, starting at page 1
The number of results returned per page. Defaults to 20.
True indicates that full election period of a candidate. False indicates that two year election cycle.
Provide a field to sort by. Use - for descending order.
Hide null values on sorted column(s).
Toggle that filters out all rows having sort column that is non-null
Toggle that sorts null values last
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.