get_candidates_search

v1.0.0

Fetch basic information about candidates and their principal committees.

Each result reflects a unique FEC candidate ID. That ID is assigned to the candidate for a particular office sought. If a candidate runs for the same office over time, that ID stays the same. If the same person runs for multiple offices — for example, a House candidate runs for a Senate office — that candidate will get a unique ID for each office.

The candidate endpoints primarily use data from FEC registration for committee information and for candidate information.

Input

{
  "type": "object",
  "properties": {
    "candidate_id": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "candidate_status": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "",
          "C",
          "F",
          "N",
          "P"
        ]
      }
    },
    "cycle": {
      "type": "array",
      "items": {
        "type": "integer",
        "format": "int32"
      }
    },
    "district": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "election_year": {
      "type": "array",
      "items": {
        "type": "integer",
        "format": "int32"
      }
    },
    "federal_funds_flag": {
      "type": "boolean"
    },
    "has_raised_funds": {
      "type": "boolean"
    },
    "incumbent_challenge": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "",
          "I",
          "C",
          "O"
        ]
      }
    },
    "is_active_candidate": {
      "type": "boolean"
    },
    "max_first_file_date": {
      "type": "string",
      "format": "date"
    },
    "min_first_file_date": {
      "type": "string",
      "format": "date"
    },
    "name": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "office": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "",
          "H",
          "S",
          "P"
        ]
      }
    },
    "page": {
      "type": "integer",
      "format": "int32"
    },
    "party": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "per_page": {
      "type": "integer",
      "format": "int32"
    },
    "q": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sort": {
      "type": "string"
    },
    "sort_hide_null": {
      "type": "boolean"
    },
    "sort_null_only": {
      "type": "boolean"
    },
    "sort_nulls_last": {
      "type": "boolean"
    },
    "state": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "year": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

Output

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