Contests

This endpoint returns Contest objects and related Election, Party, Referendum, and Candidate objects.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Partisan and Party Specific Conests

Contests can be nonpartisan, partisan, or party specific.

  • Nonpartisan - "partisan": false - display all candidates, regardless of party
  • Partisan - "partisan": true - only display the candidates that match the voter's party
  • Party Specific - "links": {"party": 1, ... - only display the contest if the voter's party matches

📘

The partisan field can be ignored for party specific contests as all party specific contests are also partisan contests.

v2 Breaking Changes from v1

maximum field in v1 was changed to voteMaximum field in v2

The following Contest fields in v1 were removed in v2

  • type - use order for sorting
  • officeName - use name
  • slug - obsolete
Query Params
string

list of contest ids (e.g '1' or '1,2,3') (NOTE: querying requires election or contests)

int32

election id (NOTE: querying requires election or contests)

string

party id

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain