get_elections

v1.0.0

Look at the top-level financial information for all candidates running for the same office.

Choose a 2-year cycle, and house, senate or presidential.

If you are looking for a Senate seat, you will need to select the state using a two-letter abbreviation.

House races require state and a two-digit district number.

Since this endpoint reflects financial information, it will only have candidates once they file financial reporting forms. Query the /candidates endpoint to retrieve an-up-to-date list of all the candidates that filed to run for a particular seat.

Input

{
  "type": "object",
  "properties": {
    "cycle": {
      "type": "integer",
      "format": "int32"
    },
    "district": {
      "type": "string"
    },
    "election_full": {
      "type": "boolean"
    },
    "office": {
      "type": "string",
      "enum": [
        "house",
        "senate",
        "president"
      ]
    },
    "page": {
      "type": "integer",
      "format": "int32"
    },
    "per_page": {
      "type": "integer",
      "format": "int32"
    },
    "sort": {
      "type": "string"
    },
    "sort_hide_null": {
      "type": "boolean"
    },
    "sort_null_only": {
      "type": "boolean"
    },
    "sort_nulls_last": {
      "type": "boolean"
    },
    "state": {
      "type": "string"
    }
  },
  "required": [
    "cycle",
    "office"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "additionalProperties": true
}