openfec — quality + safety report

---
name: openfec
description: "OpenFEC API skill. Use when working with OpenFEC for audit-case, audit-category, audit-primary-category. Covers 99 endpoints."
version: 1.0.0
generator: lapsh
---

# OpenFEC
API version: 1.0

## Auth
ApiKey X-Api-Key in header | ApiKey api_key in query | ApiKey api_key in query

## Base URL
Not specified.

## Setup
1. Set your API key in the appropriate header
2. GET /v1/audit-case/ -- verify access

## Endpoints

99 endpoints across 25 groups. See references/api-spec.lap for full details.

### audit-case
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/audit-case/ | This endpoint contains Final Audit Reports approved by the Commission since inception. |

### audit-category
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/audit-category/ | This lists the options for the categories and subcategories available in the /audit-search/ endpoint. |

### audit-primary-category
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/audit-primary-category/ | This lists the options for the primary categories available in the /audit-search/ endpoint. |

### calendar-dates
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/calendar-dates/ | Combines the election and reporting dates with Commission meetings, conferences, outreach, Advisory Opinions, rules, litigation dates and other |
| GET | /v1/calendar-dates/export/ | Returns CSV or ICS for downloading directly into calendar applications like Google, Outlook or other applications. |

### candidate
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/candidate/{candidate_id}/ | This endpoint is useful for finding detailed information about a particular candidate. Use the |
| GET | /v1/candidate/{candidate_id}/committees/ | This endpoint is useful for finding detailed information about a particular committee or |
| GET | /v1/candidate/{candidate_id}/committees/history/ | Explore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or `committee_type`. |
| GET | /v1/candidate/{candidate_id}/committees/history/{cycle}/ | Explore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or `committee_type`. |
| GET | /v1/candidate/{candidate_id}/filings/ | All official records and reports filed by or delivered to the FEC. |
| GET | /v1/candidate/{candidate_id}/history/ | Find out a candidate's characteristics over time. This is particularly useful if the |
| GET | /v1/candidate/{candidate_id}/history/{cycle}/ | Find out a candidate's characteristics over time. This is particularly useful if the |
| GET | /v1/candidate/{candidate_id}/totals/ | This endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports, |

### candidates
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/candidates/ | Fetch basic information about candidates, and use parameters to filter results to the |
| GET | /v1/candidates/search/ | Fetch basic information about candidates and their principal committees. |
| GET | /v1/candidates/totals/ | Aggregated candidate receipts and disbursements grouped by cycle. |
| GET | /v1/candidates/totals/aggregates/ | Candidate total receipts and disbursements aggregated by `aggregate_by`. |

### committee
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/committee/{committee_id}/ | This endpoint is useful for finding detailed information about a particular committee or |
| GET | /v1/committee/{committee_id}/candidates/ | This endpoint is useful for finding detailed information about a particular candidate. Use the |
| GET | /v1/committee/{committee_id}/candidates/history/ | Find out a candidate's characteristics over time. This is particularly useful if the |
| GET | /v1/committee/{committee_id}/candidates/history/{cycle}/ | Find out a candidate's characteristics over time. This is particularly useful if the |
| GET | /v1/committee/{committee_id}/filings/ | All official records and reports filed by or delivered to the FEC. |
| GET | /v1/committee/{committee_id}/history/ | Explore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or `committee_type`. |
| GET | /v1/committee/{committee_id}/history/{cycle}/ | Explore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or `committee_type`. |
| GET | /v1/committee/{committee_id}/reports/ | Each report represents the summary information from Form 3, Form 3X and Form 3P. |
| GET | /v1/committee/{committee_id}/totals/ | This endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports, |

### committees
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/committees/ | Fetch basic information about committees and filers. Use parameters to filter for |

### communication_costs
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/communication_costs/ | 52 U.S.C. 30118 allows "communications by a corporation to its stockholders and executive or administrative personnel and their families or by a labor organization to its members and their families on any subject," including the express advocacy of the election or defeat of any Federal candidate.  The costs of such communications must be reported to the Federal Election Commission under certain circumstances. |
| GET | /v1/communication_costs/aggregates/ | Communication cost aggregated by candidate ID and committee ID. |
| GET | /v1/communication_costs/by_candidate/ | Communication cost aggregated by candidate ID and committee ID. |
| GET | /v1/communication_costs/totals/by_candidate/ | Total communications costs aggregated across committees on supported or opposed candidates by cycle or candidate election year. |

### efile
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/efile/filings/ | Basic information about electronic files coming into the FEC, posted as they are received. |
| GET | /v1/efile/form1/ | Basic information about electronic files coming into the FEC, posted as they are received. |
| GET | /v1/efile/form2/ | Basic information about electronic files coming into the FEC, posted as they are received. |
| GET | /v1/efile/reports/house-senate/ | Key financial data reported periodically by committees as they are reported. This feed includes summary |
| GET | /v1/efile/reports/pac-party/ | Key financial data reported periodically by committees as they are reported. This feed includes summary |
| GET | /v1/efile/reports/presidential/ | Key financial data reported periodically by committees as they are reported. This feed includes summary |

### election-dates
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/election-dates/ | FEC election dates since 1995. |

### electioneering
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/electioneering/ | An electioneering communication is any broadcast, cable or satellite communication that fulfills each of the following conditions: |
| GET | /v1/electioneering/aggregates/ | Electioneering communications costs aggregates |
| GET | /v1/electioneering/by_candidate/ | Electioneering costs aggregated by candidate |
| GET | /v1/electioneering/totals/by_candidate/ | Total electioneering communications spent on candidates by cycle |

### elections
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/elections/ | Look at the top-level financial information for all candidates running for the same |
| GET | /v1/elections/search/ | List elections by cycle, office, state, and district. |
| GET | /v1/elections/summary/ | List elections by cycle, office, state, and district. |

### filings
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/filings/ | All official records and reports filed by or delivered to the FEC. |

### legal
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/legal/docs/{doc_type}/{no} | Search legal documents by type and number |
| GET | /v1/legal/search/ | Search legal documents by document type, or across all document types using keywords, parameter values and ranges. |

### names
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/names/audit_candidates/ | Search for candidates or committees by name. If you're looking for information on a |
| GET | /v1/names/audit_committees/ | Search for candidates or committees by name. If you're looking for information on a |
| GET | /v1/names/candidates/ | Search for candidates or committees by name. If you're looking for information on a |
| GET | /v1/names/committees/ | Search for candidates or committees by name. If you're looking for information on a |

### national_party
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/national_party/schedule_a/ | This endpoint includes national party committee account receipts for presidential nominating conventions, |
| GET | /v1/national_party/schedule_b/ | This endpoint includes national party committee account disbursements for presidential nominating conventions, |
| GET | /v1/national_party/totals/ | This endpoint includes national party committee account total receipts and total disbursements for |

### operations-log
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/operations-log/ | The Operations log contains details of each report loaded into the database. It is primarily |

### presidential
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/presidential/contributions/by_candidate/ | Net receipts per candidate. |
| GET | /v1/presidential/contributions/by_size/ | Contribution receipts by size per candidate. |
| GET | /v1/presidential/contributions/by_state/ | Contribution receipts by state per candidate. |
| GET | /v1/presidential/coverage_end_date/ | Coverage end date per candidate. |
| GET | /v1/presidential/financial_summary/ | Financial summary per candidate. |

### rad-analyst
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/rad-analyst/ | Use this endpoint to look up the RAD Analyst for a committee. |

### reporting-dates
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/reporting-dates/ | FEC election dates since 1995. |

### reports
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/reports/{entity_type}/ | Each report represents the summary information from Form 3, Form 3X and Form 3P. |

### schedules
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/schedules/schedule_a/ | This description is for both ​`/schedules​/schedule_a​/` and ​ `/schedules​/schedule_a​/{sub_id}​/`. |
| GET | /v1/schedules/schedule_a/by_employer/ | This endpoint provides itemized individual contributions received by a committee, aggregated by the contributor’s employer name. If you are interested in our “is_individual” methodology, review the [methodology page](https://www.fec.gov/campaign-finance-data/about-campaign-finance-data/methodology). Unitemized individual contributions are not included. |
| GET | /v1/schedules/schedule_a/by_occupation/ | This endpoint provides itemized individual contributions received by a committee, aggregated by the contributor’s occupation. If you are interested in our “is_individual” methodology, review the [methodology page](https://www.fec.gov/campaign-finance-data/about-campaign-finance-data/methodology). Unitemized individual contributions are not included. |
| GET | /v1/schedules/schedule_a/by_size/ | This endpoint provides individual contributions received by a committee, aggregated by size: |
| GET | /v1/schedules/schedule_a/by_size/by_candidate/ |

… (truncated)