Federal Candidate Web Service


The Candidate Web Service (Federal) is a web-based API providing comprehensive content on registered candidates running for federal office that is easily consumable using JSON or XML. Round-trip response time is less than a second, and this makes it perfect for application development and enhanced website functionality. KnowWho supplies the data, and you control the usage and design. Daily updates ensure information is current and accurate.

Features and Benefits:

  • Contact and biographical information for candidates registered to run for federal office
  • Candidate name, ethnicity, gender, party, party code, KnowWho-hosted image URL
  • Position type, state and district, race, election date, vote percentage, election status, incumbent flag, and FEC link number
  • Primary campaign office address, phone and fax numbers, email addresses, and social media URLs
  • Campaign manager or key staff name, title, and contact information (when available)
  • Use JSON or XML input to submit your request, then parse the response in the same format
  • Available for both federal and state candidates