action fec_get_candidates {
  label: "get_candidates"
  description: "\nFetch basic information about candidates, and use parameters to filter results to the\ncandidates you're looking for.\n\nEach result reflects a unique FEC candidate ID. That ID is particular to the candidate for a\nparticular office sought. If a candidate runs for the same office multiple times, the ID\nstays the same. If the same person runs for another office — for example, a House\ncandidate runs for a Senate office — that candidate will get a unique ID for each office.\n"
  provider: fec
  method: GET
  path: "/candidates/"
  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
  }
}