A candidate running in an election
Required CharField(1)
Single character flag indicating test (t) vs. live (l) election results data.
IntegerField Primary Key
National Politician ID(NPID). Uniquely assigned ID for this politician, regardless of the state or races in which this politician is a candidate.
Field may be empty if no unique ID has been assigned to this politician.
Required IntegerField Unique
AP-assigned unique ID identifying this specific candidate.
Required IntegerField
AP defined candidate number. Candidate numbers are guaranteed unique only within a single state. See Candidate.politician_id field below for the unique candidate number/ID at the National level, if available.
CharField(64)
Candidate’s first name.
CharField(64)
Candidate’s middle name.
CharField(64)
Candidate’s last name.
CharField(16)
Trailing Jr or Sr, etc.
Required BooleanField default: False
Flag indicating whether The AP appends the junior suffix to the candidate’s name in reports.
IntegerField
The year the candidate was first elected to their current office.
DateField
The candidate’s birth date
CharField(100)
The name of the place of the candidate’s birth.
CharField(2)
The two-letter state abbreviation of the state in which the candidate was born (If in the United States).
CharField(100)
The name of the province in which the candidate was born (If outside the United States).
CharField(100)
The name of the country in which the candidate was born.
CharField(100)
The name of the place in which the candidate currently lives.
CharField(2)
The two-letter state abbreviation in which the candidate currently resides.
CharField(1)
Either M for male, or F for female.
CharField(100)
The candidate’s ethnicity
CharField(100)
The candidate’s hispanic background
CharField(100)
The candidate’s declared practiced religion.
TextField
A simple biographical narrative of the candidate.
TextField
A political profile of the candidate.
TextField
Brief information about current election campaigns.
Required DateTime
When the information was last modified.