---
title: "GET /v1/electioneering/"
method: GET
path: "/v1/electioneering/"
tags: ["electioneering"]
---

# GET /v1/electioneering/

`GET /v1/electioneering/`

## Request

- Base URL: `https://api.open.fec.gov` (the document declares no server; this is the origin it was published from)
- URL: `https://api.open.fec.gov/v1/electioneering/`
- Auth: API key in header `X-Api-Key` and API key in query parameter `api_key` and API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/fec/apis/openfec/docs/v1/electioneering/get.ts> (a function with typed inputs; its response is checked against the schema)

An electioneering communication is any broadcast, cable or satellite communication that fulfills each of the following conditions:

_The communication refers to a clearly identified federal candidate._

_The communication is publicly distributed by a television station, radio station, cable television system or satellite system for a fee._

_The communication is distributed within 60 days prior to a general election or 30 days prior to a primary election to federal office._

## Query parameters

- `page` integer
- `per_page` integer
- `committee_id` string[]
- `candidate_id` string[]
- `report_year` integer[]
- `min_amount` number
- `max_amount` number
- `min_date` string
- `max_date` string
- `disbursement_description` string[]
- `last_index` integer
- `sort` string
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- ElectioneeringPage
  - `pagination` SeekInfo
    - `count` integer
    - `is_count_exact` boolean
    - `last_indexes` unknown
    - `pages` integer
    - `per_page` integer
  - `results` Electioneering[]
    - `amendment_indicator` string, nullable
    - `beginning_image_number` string, nullable
    - `calculated_candidate_share` number
    - `candidate_district` string, nullable
    - `candidate_id` string, nullable
    - `candidate_name` string, nullable
    - `candidate_office` string, nullable
    - `candidate_state` string, nullable
    - `committee_id` string, nullable
    - `committee_name` string, nullable
    - `communication_date` string, date, nullable: It is the airing, broadcast, cablecast or other dissemination of the communication.
    - `disbursement_amount` number
    - `disbursement_date` string, date, nullable: Disbursement date includes actual disbursements and execution of contracts creating an obligation to make disbursements (SB date of disbursement).
    - `election_type` string
    - `file_number` integer, nullable
    - `link_id` integer, nullable
    - `number_of_candidates` number
    - `payee_name` string, nullable: Name of the entity that received the payment.
    - `payee_state` string, nullable
    - `pdf_url` string, nullable
    - `public_distribution_date` string, date, nullable: The pubic distribution date is the date that triggers disclosure of the electioneering communication (date reported on page 1 of Form 9).
    - `purpose_description` string, nullable
    - `receipt_date` string, date, nullable
    - `report_year` integer, nullable
    - `sb_image_num` string, nullable
    - `sb_link_id` string, nullable
    - `sub_id` integer, nullable: The identifier for each electioneering record.

---

[API](https://skmtc.dev/fec/apis/openfec.md) - [All operations](https://skmtc.dev/fec/apis/openfec/llms.txt) - [OpenAPI document](https://skmtc.dev/fec/apis/openfec/revisions/d2eb3171e225?raw)