action fec_get_candidates_search {
  label: "get_candidates_search"
  description: "\nFetch basic information about candidates and their principal committees.\n\nEach result reflects a unique FEC candidate ID. That ID is assigned to the candidate for a\nparticular office sought. If a candidate runs for the same office over time, that ID\nstays the same. If the same person runs for multiple offices — for example, a House\ncandidate runs for a Senate office — that candidate will get a unique ID for each office.\n\nThe candidate endpoints primarily use data from FEC registration\n[Form 1](https://www.fec.gov/pdf/forms/fecfrm1.pdf) for committee information and\n[Form 2](https://www.fec.gov/pdf/forms/fecfrm2.pdf) for candidate information.\n"
  provider: fec
  method: GET
  path: "/candidates/search/"
  encoding: json
  input: {
    type: "object"
    properties: {
      api_key: {
        type: "string"
      }
      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"
      }
    }
    required: ["api_key"]
    additionalProperties: false
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}