A person seeking election to hold a specific public office for a term.


Information about the 14 fields and the definitions of any abbreviated values.

candidate_name   String (up to 300)

For preserving the candidate's name as it was of the candidacy.

contest   String (up to 48)

Reference to an OCD CandidateContest representing the contest in which the candidate is competing.

created_at   Date (with time)

The date and time of creation.

extras   A JSON object

A key-value store for storing arbitrary information not covered elsewhere.

filed_date   Date (without time)

Specifies when the candidate filed for the contest.

id   String (up to 50)

Open Civic Data-style id in the format ``ocd-candidacy/{{uuid}}``.

is_incumbent   Boolean (Either True or False)

Indicates whether the candidate is seeking re-election to a public office he/she currently holds

locked_fields   Array of Text

party   String (up to 53)

Reference to the Organization representing the political party that nominated the candidate or would nominate the candidate (as in the case of a partisan primary).

person   String (up to 47)

Reference to the Person who is the candidate.

post   String (up to 45)

Reference to Post representing the public office for which the candidate is seeking election.

registration_status   String (up to 10)

Registration status of the candidate.

Code Definition
filed Filed
qualified Qualified
withdrawn Withdrawn
write-in Write-in

top_ticket_candidacy   String (up to 50)

If the candidate is running as part of ticket, e.g., a Vice Presidential candidate running with a Presidential candidate, reference to candidacy at the top of the ticket.

updated_at   Date (with time)

The date and time of the last update.