flowground for Business Customers

Technical Specifications

startFlow

OnInit
./lib/triggers/startFlow.js
OnStartup
-
OnClose
-

Attributes

-

get_audit_case_

This endpoint contains Final Audit Reports approved by the Commission since inception. The search can be based on information about the audited committee (Name, FEC ID Number, Type, Election Cycle) or the issues covered in the report.

OnInit
./lib/actions/get_audit_case_.js
OnStartup
-
OnClose
-

Attributes

-

get_audit_category_

This lists the options for the categories and subcategories available in the /audit-search/ endpoint.

OnInit
./lib/actions/get_audit_category_.js
OnStartup
-
OnClose
-

Attributes

-

get_audit_primary_category_

This lists the options for the primary categories available in the /audit-search/ endpoint.

OnInit
./lib/actions/get_audit_primary_category_.js
OnStartup
-
OnClose
-

Attributes

-

get_calendar_dates_

Combines the election and reporting dates with Commission meetings, conferences, outreach, Advisory Opinions, rules, litigation dates and other events into one calendar. State and report type filtering is no longer available.

OnInit
./lib/actions/get_calendar_dates_.js
OnStartup
-
OnClose
-

Attributes

-

get_calendar_dates_export_

Returns CSV or ICS for downloading directly into calendar applications like Google, Outlook or other applications. Combines the election and reporting dates with Commission meetings, conferences, outreach, Advisory Opinions, rules, litigation dates and other events into one calendar. State filtering now applies to elections, reports and reporting periods. Presidential pre-primary report due dates are not shown on even years. Filers generally opt to file monthly rather than submit over 50 pre-primary election reports. All reporting deadlines are available at /reporting-dates/ for reference. This is [the sql function](https://github.com/fecgov/openFEC/blob/develop/data/migrations/V40__omnibus_dates.sql) that creates the calendar.

OnInit
./lib/actions/get_calendar_dates_export_.js
OnStartup
-
OnClose
-

Attributes

-

get_candidate__candidate_id__

This endpoint is useful for finding detailed information about a particular candidate. Use the `candidate_id` to find the most recent information about that candidate.

OnInit
./lib/actions/get_candidate__candidate_id__.js
OnStartup
-
OnClose
-

Attributes

-

get_candidate__candidate_id__committees_

This endpoint is useful for finding detailed information about a particular committee or filer. Use the `committee_id` to find the most recent information about the committee.

OnInit
./lib/actions/get_candidate__candidate_id__committees_.js
OnStartup
-
OnClose
-

Attributes

-

get_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`.

OnInit
./lib/actions/get_candidate__candidate_id__committees_history_.js
OnStartup
-
OnClose
-

Attributes

-

get_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`.

OnInit
./lib/actions/get_candidate__candidate_id__committees_history__cycle__.js
OnStartup
-
OnClose
-

Attributes

-

get_candidate__candidate_id__filings_

All official records and reports filed by or delivered to the FEC. Note: because the filings data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned.

OnInit
./lib/actions/get_candidate__candidate_id__filings_.js
OnStartup
-
OnClose
-

Attributes

-

get_candidate__candidate_id__history_

Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to know more about a candidate's previous races. This information is organized by `candidate_id`, so it won't help you find a candidate who ran for different offices over time; candidates get a new ID for each office.

OnInit
./lib/actions/get_candidate__candidate_id__history_.js
OnStartup
-
OnClose
-

Attributes

-

get_candidate__candidate_id__history__cycle__

Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to know more about a candidate's previous races. This information is organized by `candidate_id`, so it won't help you find a candidate who ran for different offices over time; candidates get a new ID for each office.

OnInit
./lib/actions/get_candidate__candidate_id__history__cycle__.js
OnStartup
-
OnClose
-

Attributes

-

get_candidate__candidate_id__totals_

This endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports, which are aggregated by two-year period. We refer to two-year periods as a `cycle`. The cycle is named after the even-numbered year and includes the year before it. To see totals from 2013 and 2014, you would use 2014. In odd-numbered years, the current cycle is the next year -- for example, in 2015, the current cycle is 2016. For presidential and Senate candidates, multiple two-year cycles exist between elections.

OnInit
./lib/actions/get_candidate__candidate_id__totals_.js
OnStartup
-
OnClose
-

Attributes

-

get_candidates_

Fetch basic information about candidates, and use parameters to filter results to the candidates you're looking for. Each result reflects a unique FEC candidate ID. That ID is particular to the candidate for a particular office sought. If a candidate runs for the same office multiple times, the ID stays the same. If the same person runs for another office -- for example, a House candidate runs for a Senate office -- that candidate will get a unique ID for each office.

OnInit
./lib/actions/get_candidates_.js
OnStartup
-
OnClose
-

Attributes

-

get_candidates_search_

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 [Form 1](http://www.fec.gov/pdf/forms/fecfrm1.pdf), for candidate information, and [Form 2](http://www.fec.gov/pdf/forms/fecfrm2.pdf), for committees information, with additional information to provide context.

OnInit
./lib/actions/get_candidates_search_.js
OnStartup
-
OnClose
-

Attributes

-

get_candidates_totals_

Aggregated candidate receipts and disbursements grouped by cycle.

OnInit
./lib/actions/get_candidates_totals_.js
OnStartup
-
OnClose
-

Attributes

-

get_candidates_totals_by_office_

Aggregated candidate receipts and disbursements grouped by office by cycle.

OnInit
./lib/actions/get_candidates_totals_by_office_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__

This endpoint is useful for finding detailed information about a particular committee or filer. Use the `committee_id` to find the most recent information about the committee.

OnInit
./lib/actions/get_committee__committee_id__.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__candidates_

This endpoint is useful for finding detailed information about a particular candidate. Use the `candidate_id` to find the most recent information about that candidate.

OnInit
./lib/actions/get_committee__committee_id__candidates_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__candidates_history_

Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to know more about a candidate's previous races. This information is organized by `candidate_id`, so it won't help you find a candidate who ran for different offices over time; candidates get a new ID for each office.

OnInit
./lib/actions/get_committee__committee_id__candidates_history_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__candidates_history__cycle__

Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to know more about a candidate's previous races. This information is organized by `candidate_id`, so it won't help you find a candidate who ran for different offices over time; candidates get a new ID for each office.

OnInit
./lib/actions/get_committee__committee_id__candidates_history__cycle__.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__communication_costs_by_candidate_

Communication cost aggregated by candidate ID and committee ID.

OnInit
./lib/actions/get_committee__committee_id__communication_costs_by_candidate_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__electioneering_by_candidate_

Electioneering costs aggregated by candidate.

OnInit
./lib/actions/get_committee__committee_id__electioneering_by_candidate_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__filings_

All official records and reports filed by or delivered to the FEC. Note: because the filings data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned.

OnInit
./lib/actions/get_committee__committee_id__filings_.js
OnStartup
-
OnClose
-

Attributes

-

get_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`.

OnInit
./lib/actions/get_committee__committee_id__history_.js
OnStartup
-
OnClose
-

Attributes

-

get_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`.

OnInit
./lib/actions/get_committee__committee_id__history__cycle__.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__reports_

Each report represents the summary information from FEC Form 3, Form 3X and Form 3P. These reports have key statistics that illuminate the financial status of a given committee. Things like cash on hand, debts owed by committee, total receipts, and total disbursements are especially helpful for understanding a committee's financial dealings. By default, this endpoint includes both amended and final versions of each report. To restrict to only the final versions of each report, use `is_amended=false`; to view only reports that have been amended, use `is_amended=true`. Several different reporting structures exist, depending on the type of organization that submits financial information. To see an example of these reporting requirements, look at the summary and detailed summary pages of FEC Form 3, Form 3X, and Form 3P. DISCLAIMER: The field labels contained within this resource are subject to change. We are attempting to succinctly label these fields while conveying clear meaning to ensure accessibility for all users.

OnInit
./lib/actions/get_committee__committee_id__reports_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__schedules_schedule_a_by_employer_

Schedule A receipts aggregated by contributor employer name. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_committee__committee_id__schedules_schedule_a_by_employer_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__schedules_schedule_a_by_occupation_

Schedule A receipts aggregated by contributor occupation. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_committee__committee_id__schedules_schedule_a_by_occupation_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__schedules_schedule_a_by_size_

This endpoint aggregates Schedule A donations based on size: ``` - $200 and under - $200.01 - $499.99 - $500 - $999.99 - $1000 - $1999.99 - $2000 + ``` In cases where the donations are $200 or less, the results include small donations that are reported on Schedule A, but filers are not required to itemize those small donations, so we also add unitemized contributions. Unitemized contributions come from the summary section of the forms. It represents the total money brought in from donors that are not reported on Schedule A and have given $200 or less.

OnInit
./lib/actions/get_committee__committee_id__schedules_schedule_a_by_size_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__schedules_schedule_a_by_state_

Schedule A individual receipts aggregated by contributor state. This is an aggregate of only individual contributions. To avoid double counting, memoed items are not included. Transactions $200 and under do not have to be itemized, if those contributions are not itemized, they will not be included in the state totals.

OnInit
./lib/actions/get_committee__committee_id__schedules_schedule_a_by_state_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__schedules_schedule_a_by_zip_

Schedule A receipts aggregated by contributor zip code. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_committee__committee_id__schedules_schedule_a_by_zip_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__schedules_schedule_b_by_purpose_

Schedule B disbursements aggregated by disbursement purpose category. To avoid double counting, memoed items are not included. Purpose is a combination of transaction codes, category codes and disbursement description. See the `disbursement_purpose` sql function within the migrations for more details.

OnInit
./lib/actions/get_committee__committee_id__schedules_schedule_b_by_purpose_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__schedules_schedule_b_by_recipient_

Schedule B disbursements aggregated by recipient name. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_committee__committee_id__schedules_schedule_b_by_recipient_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__schedules_schedule_b_by_recipient_id_

Schedule B disbursements aggregated by recipient committee ID, if applicable. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_committee__committee_id__schedules_schedule_b_by_recipient_id_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__schedules_schedule_e_by_candidate_

Schedule E receipts aggregated by recipient candidate. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_committee__committee_id__schedules_schedule_e_by_candidate_.js
OnStartup
-
OnClose
-

Attributes

-

get_committee__committee_id__totals_

This endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports, which are aggregated by two-year period. We refer to two-year periods as a `cycle`. The cycle is named after the even-numbered year and includes the year before it. To see totals from 2013 and 2014, you would use 2014. In odd-numbered years, the current cycle is the next year -- for example, in 2015, the current cycle is 2016. For presidential and Senate candidates, multiple two-year cycles exist between elections.

OnInit
./lib/actions/get_committee__committee_id__totals_.js
OnStartup
-
OnClose
-

Attributes

-

get_committees_

Fetch basic information about committees and filers. Use parameters to filter for particular characteristics.

OnInit
./lib/actions/get_committees_.js
OnStartup
-
OnClose
-

Attributes

-

get_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.

OnInit
./lib/actions/get_communication_costs_.js
OnStartup
-
OnClose
-

Attributes

-

get_communication_costs_by_candidate_

Communication cost aggregated by candidate ID and committee ID.

OnInit
./lib/actions/get_communication_costs_by_candidate_.js
OnStartup
-
OnClose
-

Attributes

-

get_efile_filings_

Basic information about electronic files coming into the FEC, posted as they are received.

OnInit
./lib/actions/get_efile_filings_.js
OnStartup
-
OnClose
-

Attributes

-

get_efile_reports_house_senate_

Key financial data reported periodically by committees as they are reported. This feed includes summary information from the the House F3 reports, the presidential F3p reports and the PAC and party F3x reports. Generally, committees file reports on a quarterly or monthly basis, but some must also submit a report 12 days before primary elections. Therefore, during the primary season, the period covered by this file may be different for different committees. These totals also incorporate any changes made by committees, if any report covering the period is amended. DISCLAIMER: The field labels contained within this resource are subject to change. We are attempting to succinctly label these fields while conveying clear meaning to ensure accessibility for all users.

OnInit
./lib/actions/get_efile_reports_house_senate_.js
OnStartup
-
OnClose
-

Attributes

-

get_efile_reports_pac_party_

Key financial data reported periodically by committees as they are reported. This feed includes summary information from the the House F3 reports, the presidential F3p reports and the PAC and party F3x reports. Generally, committees file reports on a quarterly or monthly basis, but some must also submit a report 12 days before primary elections. Therefore, during the primary season, the period covered by this file may be different for different committees. These totals also incorporate any changes made by committees, if any report covering the period is amended. DISCLAIMER: The field labels contained within this resource are subject to change. We are attempting to succinctly label these fields while conveying clear meaning to ensure accessibility for all users.

OnInit
./lib/actions/get_efile_reports_pac_party_.js
OnStartup
-
OnClose
-

Attributes

-

get_efile_reports_presidential_

Key financial data reported periodically by committees as they are reported. This feed includes summary information from the the House F3 reports, the presidential F3p reports and the PAC and party F3x reports. Generally, committees file reports on a quarterly or monthly basis, but some must also submit a report 12 days before primary elections. Therefore, during the primary season, the period covered by this file may be different for different committees. These totals also incorporate any changes made by committees, if any report covering the period is amended. DISCLAIMER: The field labels contained within this resource are subject to change. We are attempting to succinctly label these fields while conveying clear meaning to ensure accessibility for all users.

OnInit
./lib/actions/get_efile_reports_presidential_.js
OnStartup
-
OnClose
-

Attributes

-

get_election_dates_

FEC election dates since 1995.

OnInit
./lib/actions/get_election_dates_.js
OnStartup
-
OnClose
-

Attributes

-

get_electioneering_

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._

OnInit
./lib/actions/get_electioneering_.js
OnStartup
-
OnClose
-

Attributes

-

get_electioneering_by_candidate_

Electioneering costs aggregated by candidate.

OnInit
./lib/actions/get_electioneering_by_candidate_.js
OnStartup
-
OnClose
-

Attributes

-

get_elections_

Look at the top-level financial information for all candidates running for the same office. Choose a 2-year cycle, and `house`, `senate` or `presidential`. If you are looking for a Senate seat, you will need to select the state using a two-letter abbreviation. House races require state and a two-digit district number. Since this endpoint reflects financial information, it will only have candidates once they file financial reporting forms. Query the `/candidates` endpoint to see an up to date list of all the candidates that filed to run for a particular seat.

OnInit
./lib/actions/get_elections_.js
OnStartup
-
OnClose
-

Attributes

-

get_elections_search_

List elections by cycle, office, state, and district.

OnInit
./lib/actions/get_elections_search_.js
OnStartup
-
OnClose
-

Attributes

-

get_elections_summary_

List elections by cycle, office, state, and district.

OnInit
./lib/actions/get_elections_summary_.js
OnStartup
-
OnClose
-

Attributes

-

get_filings_

All official records and reports filed by or delivered to the FEC. Note: because the filings data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned.

OnInit
./lib/actions/get_filings_.js
OnStartup
-
OnClose
-

Attributes

-

get_legal_search_

Search legal documents by type, or across all document types using keywords, parameter values and ranges.

OnInit
./lib/actions/get_legal_search_.js
OnStartup
-
OnClose
-

Attributes

-

get_names_audit_candidates_

Search for candidates or committees by name. If you're looking for information on a particular person or group, using a name to find the `candidate_id` or `committee_id` on this endpoint can be a helpful first step.

OnInit
./lib/actions/get_names_audit_candidates_.js
OnStartup
-
OnClose
-

Attributes

-

get_names_audit_committees_

Search for candidates or committees by name. If you're looking for information on a particular person or group, using a name to find the `candidate_id` or `committee_id` on this endpoint can be a helpful first step.

OnInit
./lib/actions/get_names_audit_committees_.js
OnStartup
-
OnClose
-

Attributes

-

get_names_candidates_

Search for candidates or committees by name. If you're looking for information on a particular person or group, using a name to find the `candidate_id` or `committee_id` on this endpoint can be a helpful first step.

OnInit
./lib/actions/get_names_candidates_.js
OnStartup
-
OnClose
-

Attributes

-

get_names_committees_

Search for candidates or committees by name. If you're looking for information on a particular person or group, using a name to find the `candidate_id` or `committee_id` on this endpoint can be a helpful first step.

OnInit
./lib/actions/get_names_committees_.js
OnStartup
-
OnClose
-

Attributes

-

get_operations_log_

The Operations log contains details of each report loaded into the database. It is primarily used as status check to determine when all of the data processes, from initial entry through review are complete.

OnInit
./lib/actions/get_operations_log_.js
OnStartup
-
OnClose
-

Attributes

-

get_rad_analyst_

Use this endpoint to look up the RAD Analyst for a committee. The mission of the Reports Analysis Division (RAD) is to ensure that campaigns and political committees file timely and accurate reports that fully disclose their financial activities. RAD is responsible for reviewing statements and financial reports filed by political committees participating in federal elections, providing assistance and guidance to the committees to properly file their reports, and for taking appropriate action to ensure compliance with the Federal Election Campaign Act (FECA).

OnInit
./lib/actions/get_rad_analyst_.js
OnStartup
-
OnClose
-

Attributes

-

get_reporting_dates_

FEC election dates since 1995.

OnInit
./lib/actions/get_reporting_dates_.js
OnStartup
-
OnClose
-

Attributes

-

get_reports__committee_type__

Each report represents the summary information from FEC Form 3, Form 3X and Form 3P. These reports have key statistics that illuminate the financial status of a given committee. Things like cash on hand, debts owed by committee, total receipts, and total disbursements are especially helpful for understanding a committee's financial dealings. By default, this endpoint includes both amended and final versions of each report. To restrict to only the final versions of each report, use `is_amended=false`; to view only reports that have been amended, use `is_amended=true`. Several different reporting structures exist, depending on the type of organization that submits financial information. To see an example of these reporting requirements, look at the summary and detailed summary pages of FEC Form 3, Form 3X, and Form 3P. DISCLAIMER: The field labels contained within this resource are subject to change. We are attempting to succinctly label these fields while conveying clear meaning to ensure accessibility for all users.

OnInit
./lib/actions/get_reports__committee_type__.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_

Schedule A records describe itemized receipts reported by a committee. This is where you can look for individual contributors. If you are interested in individual donors, `/schedules/schedule_a` will be the endpoint you use. Once a person gives more than a total of $200, the donations of that person must be reported by committees that file F3, F3X and F3P forms. Contributions $200 and under are not required to be itemized, but you can find the total amount of these small donations by looking up the "unitemized" field in the `/reports` or `/totals` endpoints. When comparing the totals from reports to line items. the totals will not match unless you only look at items where `"is_individual":true` since the same transaction is in the data multiple ways to explain the way it may move though different committees as an earmark. See the `is_individual` sql function within the migrations for more details. For the Schedule A aggregates, such as by_occupation and by_state, include only unique individual contributions. See below for full methodology. __Methodology for determining unique, individual contributions__ For receipts over $200 use FEC code line_number to identify individuals. The line numbers that specify individuals that are automatically included: Line number with description - 10 Contribution to Independent Expenditure-Only Committees (Super PACs), Political Committees with non-contribution accounts (Hybrid PACs) and nonfederal party "soft money" accounts (1991-2002) from a person (individual, partnership, limited liability company, corporation, labor organization, or any other organization or group of persons) - 15 Contribution to political committees (other than Super PACs and Hybrid PACs) from an individual, partnership or limited liability company - 15E Earmarked contributions to political committees (other than Super PACs and Hybrid PACs) from an individual, partnership or limited liability company - 15J Memo - Recipient committee's percentage of contribution from an individual, partnership or limited liability company given to joint fundraising committee - 18J | Memo - Recipient committee's percentage of contribution from a registered committee given to joint fundraising committee - 30, 30T, 31, 31T, 32 Individual party codes For receipts under $200: We check the following codes and see if there is "earmark" (or a variation) in the `memo_text` description of the contribution. Line number with description -11AI The itemized individual contributions from F3 schedule A -12 Nonfederal other receipt - Levin Account (Line 2) -17 Itemized individual contributions from Form 3P -17A Itemized individual contributions from Form 3P -18 Itemized individual contributions from Form 3P Of those transactions,[under $200, and having "earmark" in the memo text OR transactions having the codes 11A, 12, 17, 17A, or 18], we then want to exclude earmarks. All receipt data is divided in two-year periods, called `two_year_transaction_period`, which is derived from the `report_year` submitted of the corresponding form. If no value is supplied, the results will default to the most recent two-year period that is named after the ending, even-numbered year. Due to the large quantity of Schedule A filings, this endpoint is not paginated by page number. Instead, you can request the next page of results by adding the values in the `last_indexes` object from `pagination` to the URL of your last request. For example, when sorting by `contribution_receipt_date`, you might receive a page of results with the following pagination information: ``` pagination: { pages: 2152643, per_page: 20, count: 43052850, last_indexes: { last_index: "230880619", last_contribution_receipt_date: "2014-01-01" } } ``` To fetch the next page of sorted results, append `last_index=230880619` and `last_contribution_receipt_date=2014-01-01` to the URL. We strongly advise paging through these results by using sort indices (defaults to sort by contribution date), otherwise some resources may be unintentionally filtered out. This resource uses keyset pagination to improve query performance and these indices are required to properly page through this large dataset. Note: because the Schedule A data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned.

OnInit
./lib/actions/get_schedules_schedule_a_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_by_employer_

Schedule A receipts aggregated by contributor employer name. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_schedules_schedule_a_by_employer_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_by_occupation_

Schedule A receipts aggregated by contributor occupation. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_schedules_schedule_a_by_occupation_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_by_size_

This endpoint aggregates Schedule A donations based on size: ``` - $200 and under - $200.01 - $499.99 - $500 - $999.99 - $1000 - $1999.99 - $2000 + ``` In cases where the donations are $200 or less, the results include small donations that are reported on Schedule A, but filers are not required to itemize those small donations, so we also add unitemized contributions. Unitemized contributions come from the summary section of the forms. It represents the total money brought in from donors that are not reported on Schedule A and have given $200 or less.

OnInit
./lib/actions/get_schedules_schedule_a_by_size_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_by_size_by_candidate_

Schedule A receipts aggregated by contribution size for a candidate.

OnInit
./lib/actions/get_schedules_schedule_a_by_size_by_candidate_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_by_state_

Schedule A individual receipts aggregated by contributor state. This is an aggregate of only individual contributions. To avoid double counting, memoed items are not included. Transactions $200 and under do not have to be itemized, if those contributions are not itemized, they will not be included in the state totals.

OnInit
./lib/actions/get_schedules_schedule_a_by_state_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_by_state_by_candidate_

Schedule A receipts aggregated by contribution state for a candidate.

OnInit
./lib/actions/get_schedules_schedule_a_by_state_by_candidate_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_by_state_totals_

Schedule A individual receipts aggregated by contributor state. This is an aggregate of only individual contributions. To avoid double counting, memoed items are not included. Transactions $200 and under do not have to be itemized, if those contributions are not itemized, they will not be included in the state totals. These receipts are then added together by committee type for the total amount of each type, grouped by state and cycle.

OnInit
./lib/actions/get_schedules_schedule_a_by_state_totals_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_by_zip_

Schedule A receipts aggregated by contributor zip code. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_schedules_schedule_a_by_zip_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a_efile_

Efiling endpoints provide real-time campaign finance data for electronic filers. These endpoints are perfect for watching filings roll in when you want to know the latest information. Efiling endpoints only contain the most recent two years worth of data and don't contain the processed and coded data that you can find on the other endpoints. Those endpoints are better for in-depth analysis. Senate candidates and committees are required to file by paper. Other committees who raise and spend less than $50,000 in a calendar can choose whether to file electronically or by paper. DISCLAIMER: The field labels contained within this resource are subject to change. We are attempting to succinctly label these fields while conveying clear meaning to ensure accessibility for all users.

OnInit
./lib/actions/get_schedules_schedule_a_efile_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_a__sub_id__

Schedule A records describe itemized receipts reported by a committee. This is where you can look for individual contributors. If you are interested in individual donors, `/schedules/schedule_a` will be the endpoint you use. Once a person gives more than a total of $200, the donations of that person must be reported by committees that file F3, F3X and F3P forms. Contributions $200 and under are not required to be itemized, but you can find the total amount of these small donations by looking up the "unitemized" field in the `/reports` or `/totals` endpoints. When comparing the totals from reports to line items. the totals will not match unless you only look at items where `"is_individual":true` since the same transaction is in the data multiple ways to explain the way it may move though different committees as an earmark. See the `is_individual` sql function within the migrations for more details. For the Schedule A aggregates, such as by_occupation and by_state, include only unique individual contributions. See below for full methodology. __Methodology for determining unique, individual contributions__ For receipts over $200 use FEC code line_number to identify individuals. The line numbers that specify individuals that are automatically included: Line number with description - 10 Contribution to Independent Expenditure-Only Committees (Super PACs), Political Committees with non-contribution accounts (Hybrid PACs) and nonfederal party "soft money" accounts (1991-2002) from a person (individual, partnership, limited liability company, corporation, labor organization, or any other organization or group of persons) - 15 Contribution to political committees (other than Super PACs and Hybrid PACs) from an individual, partnership or limited liability company - 15E Earmarked contributions to political committees (other than Super PACs and Hybrid PACs) from an individual, partnership or limited liability company - 15J Memo - Recipient committee's percentage of contribution from an individual, partnership or limited liability company given to joint fundraising committee - 18J | Memo - Recipient committee's percentage of contribution from a registered committee given to joint fundraising committee - 30, 30T, 31, 31T, 32 Individual party codes For receipts under $200: We check the following codes and see if there is "earmark" (or a variation) in the `memo_text` description of the contribution. Line number with description -11AI The itemized individual contributions from F3 schedule A -12 Nonfederal other receipt - Levin Account (Line 2) -17 Itemized individual contributions from Form 3P -17A Itemized individual contributions from Form 3P -18 Itemized individual contributions from Form 3P Of those transactions,[under $200, and having "earmark" in the memo text OR transactions having the codes 11A, 12, 17, 17A, or 18], we then want to exclude earmarks. All receipt data is divided in two-year periods, called `two_year_transaction_period`, which is derived from the `report_year` submitted of the corresponding form. If no value is supplied, the results will default to the most recent two-year period that is named after the ending, even-numbered year. Due to the large quantity of Schedule A filings, this endpoint is not paginated by page number. Instead, you can request the next page of results by adding the values in the `last_indexes` object from `pagination` to the URL of your last request. For example, when sorting by `contribution_receipt_date`, you might receive a page of results with the following pagination information: ``` pagination: { pages: 2152643, per_page: 20, count: 43052850, last_indexes: { last_index: "230880619", last_contribution_receipt_date: "2014-01-01" } } ``` To fetch the next page of sorted results, append `last_index=230880619` and `last_contribution_receipt_date=2014-01-01` to the URL. We strongly advise paging through these results by using sort indices (defaults to sort by contribution date), otherwise some resources may be unintentionally filtered out. This resource uses keyset pagination to improve query performance and these indices are required to properly page through this large dataset. Note: because the Schedule A data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned.

OnInit
./lib/actions/get_schedules_schedule_a__sub_id__.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_b_

Schedule B filings describe itemized disbursements. This data explains how committees and other filers spend their money. These figures are reported as part of forms F3, F3X and F3P. The data is divided in two-year periods, called `two_year_transaction_period`, which is derived from the `report_year` submitted of the corresponding form. If no value is supplied, the results will default to the most recent two-year period that is named after the ending, even-numbered year. Due to the large quantity of Schedule B filings, this endpoint is not paginated by page number. Instead, you can request the next page of results by adding the values in the `last_indexes` object from `pagination` to the URL of your last request. For example, when sorting by `disbursement_date`, you might receive a page of results with the following pagination information: ``` pagination: { pages: 965191, per_page: 20, count: 19303814, last_indexes: { last_index: "230906248", last_disbursement_date: "2014-07-04" } } ``` To fetch the next page of sorted results, append `last_index=230906248` and `last_disbursement_date=2014-07-04` to the URL. We strongly advise paging through these results by using the sort indices (defaults to sort by disbursement date, e.g. `last_disbursement_date`), otherwise some resources may be unintentionally filtered out. This resource uses keyset pagination to improve query performance and these indices are required to properly page through this large dataset. Note: because the Schedule B data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned.

OnInit
./lib/actions/get_schedules_schedule_b_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_b_by_purpose_

Schedule B disbursements aggregated by disbursement purpose category. To avoid double counting, memoed items are not included. Purpose is a combination of transaction codes, category codes and disbursement description. See the `disbursement_purpose` sql function within the migrations for more details.

OnInit
./lib/actions/get_schedules_schedule_b_by_purpose_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_b_by_recipient_

Schedule B disbursements aggregated by recipient name. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_schedules_schedule_b_by_recipient_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_b_by_recipient_id_

Schedule B disbursements aggregated by recipient committee ID, if applicable. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_schedules_schedule_b_by_recipient_id_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_b_efile_

Efiling endpoints provide real-time campaign finance data for electronic filers. These endpoints are perfect for watching filings roll in when you want to know the latest information. Efiling endpoints only contain the most recent two years worth of data and don't contain the processed and coded data that you can find on the other endpoints. Those endpoints are better for in-depth analysis. Senate candidates and committees are required to file by paper. Other committees who raise and spend less than $50,000 in a calendar can choose whether to file electronically or by paper. DISCLAIMER: The field labels contained within this resource are subject to change. We are attempting to succinctly label these fields while conveying clear meaning to ensure accessibility for all users.

OnInit
./lib/actions/get_schedules_schedule_b_efile_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_b__sub_id__

Schedule B filings describe itemized disbursements. This data explains how committees and other filers spend their money. These figures are reported as part of forms F3, F3X and F3P. The data is divided in two-year periods, called `two_year_transaction_period`, which is derived from the `report_year` submitted of the corresponding form. If no value is supplied, the results will default to the most recent two-year period that is named after the ending, even-numbered year. Due to the large quantity of Schedule B filings, this endpoint is not paginated by page number. Instead, you can request the next page of results by adding the values in the `last_indexes` object from `pagination` to the URL of your last request. For example, when sorting by `disbursement_date`, you might receive a page of results with the following pagination information: ``` pagination: { pages: 965191, per_page: 20, count: 19303814, last_indexes: { last_index: "230906248", last_disbursement_date: "2014-07-04" } } ``` To fetch the next page of sorted results, append `last_index=230906248` and `last_disbursement_date=2014-07-04` to the URL. We strongly advise paging through these results by using the sort indices (defaults to sort by disbursement date, e.g. `last_disbursement_date`), otherwise some resources may be unintentionally filtered out. This resource uses keyset pagination to improve query performance and these indices are required to properly page through this large dataset. Note: because the Schedule B data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned.

OnInit
./lib/actions/get_schedules_schedule_b__sub_id__.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_c_

Schedule C shows all loans, endorsements and loan guarantees a committee receives or makes. The committee continues to report the loan until it is repaid.

OnInit
./lib/actions/get_schedules_schedule_c_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_c__sub_id__

Schedule C shows all loans, endorsements and loan guarantees a committee receives or makes. The committee continues to report the loan until it is repaid.

OnInit
./lib/actions/get_schedules_schedule_c__sub_id__.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_d_

Schedule D, it shows debts and obligations owed to or by the committee that are required to be disclosed.

OnInit
./lib/actions/get_schedules_schedule_d_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_d__sub_id__

Schedule D, it shows debts and obligations owed to or by the committee that are required to be disclosed.

OnInit
./lib/actions/get_schedules_schedule_d__sub_id__.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_e_

Schedule E covers the line item expenditures for independent expenditures. For example, if a super PAC bought ads on TV to oppose a federal candidate, each ad purchase would be recorded here with the expenditure amount, name and id of the candidate, and whether the ad supported or opposed the candidate. An independent expenditure is an expenditure for a communication "expressly advocating the election or defeat of a clearly identified candidate that is not made in cooperation, consultation, or concert with, or at the request or suggestion of, a candidate, a candidate's authorized committee, or their agents, or a political party or its agents." Aggregates by candidate do not include 24 and 48 hour reports. This ensures we don't double count expenditures and the totals are more accurate. You can still find the information from 24 and 48 hour reports in `/schedule/schedule_e/`. Due to the large quantity of Schedule E filings, this endpoint is not paginated by page number. Instead, you can request the next page of results by adding the values in the `last_indexes` object from `pagination` to the URL of your last request. For example, when sorting by `expenditure_amount`, you might receive a page of results with the following pagination information: ``` "pagination": { "count": 152623, "last_indexes": { "last_index": "3023037", "last_expenditure_amount": -17348.5 }, "per_page": 20, "pages": 7632 } } ``` To fetch the next page of sorted results, append `last_index=3023037` and `last_expenditure_amount=` to the URL. We strongly advise paging through these results by using the sort indices (defaults to sort by disbursement date, e.g. `last_disbursement_date`), otherwise some resources may be unintentionally filtered out. This resource uses keyset pagination to improve query performance and these indices are required to properly page through this large dataset. Note: because the Schedule E data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned.

OnInit
./lib/actions/get_schedules_schedule_e_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_e_by_candidate_

Schedule E receipts aggregated by recipient candidate. To avoid double counting, memoed items are not included.

OnInit
./lib/actions/get_schedules_schedule_e_by_candidate_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_e_efile_

Efiling endpoints provide real-time campaign finance data for electronic filers. These endpoints are perfect for watching filings roll in when you want to know the latest information. Efiling endpoints only contain the most recent two years worth of data and don't contain the processed and coded data that you can find on the other endpoints. Those endpoints are better for in-depth analysis. Senate candidates and committees are required to file by paper. Other committees who raise and spend less than $50,000 in a calendar can choose whether to file electronically or by paper. DISCLAIMER: The field labels contained within this resource are subject to change. We are attempting to succinctly label these fields while conveying clear meaning to ensure accessibility for all users.

OnInit
./lib/actions/get_schedules_schedule_e_efile_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_f_

Schedule F, it shows all special expenditures a national or state party committee makes in connection with the general election campaigns of federal candidates. These coordinated party expenditures do not count against the contribution limits but are subject to other limits, these limits are detailed in Chapter 7 of the FEC Campaign Guide for Political Party Committees.

OnInit
./lib/actions/get_schedules_schedule_f_.js
OnStartup
-
OnClose
-

Attributes

-

get_schedules_schedule_f__sub_id__

Schedule F, it shows all special expenditures a national or state party committee makes in connection with the general election campaigns of federal candidates. These coordinated party expenditures do not count against the contribution limits but are subject to other limits, these limits are detailed in Chapter 7 of the FEC Campaign Guide for Political Party Committees.

OnInit
./lib/actions/get_schedules_schedule_f__sub_id__.js
OnStartup
-
OnClose
-

Attributes

-

get_state_election_office_

State laws and procedures govern elections for state or local offices as well as how candidates appear on election ballots. Contact the appropriate state election office for more information.

OnInit
./lib/actions/get_state_election_office_.js
OnStartup
-
OnClose
-

Attributes

-

get_totals_by_entity_

Provides cumulative receipt totals by entity type, over a two year cycle. Totals are adjusted to avoid double counting. This is [the sql](https://github.com/fecgov/openFEC/blob/develop/data/migrations/V41__large_aggregates.sql) that creates these calculations.

OnInit
./lib/actions/get_totals_by_entity_.js
OnStartup
-
OnClose
-

Attributes

-

get_totals__committee_type__

This endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports, which are aggregated by two-year period. We refer to two-year periods as a `cycle`. The cycle is named after the even-numbered year and includes the year before it. To see totals from 2013 and 2014, you would use 2014. In odd-numbered years, the current cycle is the next year -- for example, in 2015, the current cycle is 2016. For presidential and Senate candidates, multiple two-year cycles exist between elections.

OnInit
./lib/actions/get_totals__committee_type__.js
OnStartup
-
OnClose
-

Attributes

-

No data available for terms

No data available for environment