skip navigation
Here's how you know US flag signifying that this is a United States Federal Government website

An official website of the United States government

Here's how you know

Dot gov

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

SSL

Secure .gov websites use HTTPS
A lock ( ) or https:// means you've safely connected to the .gov website. Share sensitive information only on official, secure websites.

New statements of candidacy file description

The new statements of candidacy file lists all individuals who have filed a Statement of Candidacy (Form 2) with the federal election for:

  • U.S. House of Representatives

  • U.S. Senate

  • U.S. President

Data is available for one future election cycle, the current cycle and election cycles back to 2008. Special elections for House and Senate are also included.

Individuals may explore the feasibility of becoming a candidate. Once an individual begins to campaign or decides to become a candidate, funds that were raised or spent to test the waters apply to the $5,000 threshold for qualifying as a candidate. Once that threshold is exceeded, the individual must register and begin filing reports.

New statements of candidacy file format

Column name Field name Position Null Data type Description Example data
CANDIDATE_ID Candidate identification 1 N VARCHAR2(2)
A 9-character alpha-numeric code assigned to a candidate by the Federal Election Commission. The candidate ID for a specific candidate remains the same across election cycles as long as the candidate is running for the same office. H8VA01233
CANDIDATE_NAME
Candidate name 2 Y VARCHAR2(90)
Martha Washington
PARTY
Party name 3 Y VARCHAR2(50)
Political party description None
PARTY_CODE
Party code
4 Y VARCHAR2(3) Three characther political party affiliation code reported by the candidate. NON
CANDIDATE_OFFICE
Candidate office 5 Y VARCHAR2(9)
House
CANDIDATE_OFFICE_CODE
Candidate office code
6 Y VARCHAR2(1) H = House
P = President
S = Senate
H
CANDIDATE_OFFICE_STATE
Candidate office state
7 Y VARCHAR2(40) House = state of race
President= US
Senate = state of race
Virginia
CANDIDATE_OFFICE_STATE_CODE
Candidate office state abbreviation
8 Y VARCHAR2(2) VA
CANDIDATE_OFFICE_DISTRICT
Candidate office district
12 Y VARCHAR2(2)
Congressional district number
Congressional at large 00
Senate 00
Presidential 00
01
CITY
Mailing address - city
9 Y VARCHAR2(30) Mailing address - city Alexandria
STATE
Mailing address - state
10 Y VARCHAR2(2)
Mailing address -state VA
ZIP Mailing address - ZIP code 11 Y VARCHAR2(9) Mailing address - ZIP code 22201
ELECTION_YEAR
Election cycle Y=year
13 Y VARCHAR2(4)
Candidate's election year from a Statement of Candidacy 2018
RECEIPT_DATE
Receipt date
13 Y Date
Receipt date 01/01/2018
REPORT_YEAR
Report year
14 Y VARCHAR2(4)
2018
BEGIN_IMAGE_NUM
Beginning image number
15 Y VARCHAR2(11) or VARCHAR2(18)
11-digit image number format
YYOORRRFFFF
YY - scanning year
OO - office (01 - House, 02 - Senate, 03 - FEC Paper, 90-99 - FEC Electronic)
RRR - reel number
FFFF- frame number
18-digit Image Number Format (June 29, 2015)
YYYYMMDDSSPPPPPPPP
YYYY - scanning year
MM - scanning month
DD - scanning day
SS - source (02 - Senate, 03 - FEC Paper, 90-99 - FEC Electronic)
PPPPPPPP - page (reset to zero every year on January 1)
201801019012345678