OpenFEC API
Mock the OpenFEC API in seconds. This application programming interface (API) allows you to explore the way candidates and committees fund their campaigns.
[01]
About
Mock the OpenFEC API as a turnkey Mockzilla sim with 92 OpenAPI endpoints, realistic JSON payloads, no upstream signup or sandbox keys. This application programming interface (API) allows you to explore the way candidates and committees fund their campaigns. Methods: 92x GET. Top resource groups: candidate, receipts, financial, committee. Hit https://api.justmocks.com/openfec for the Mockzilla API Explorer landing and per-endpoint sample requests.
Endpoints
92 across 19 resource groups
Methods
GET 92 none deprecated
OpenAPI
3.0.0 spec version 1.0
Source spec
1003 KB · YAML
view raw →
[02]
Endpoints
| 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. Mocked via Mockzilla.
|
| GET |
/audit-category/
|
This lists the options for the categories and subcategories available in the /audit-search/ endpoint.
|
| GET |
/audit-primary-category/
|
This lists the options for the primary categories available in the /audit-search/ endpoint.
|
| 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.
|
| 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 that creates the calendar.
|
| 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. Available as a Mockzilla mock endpoint.
|
| 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.
|
| 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.
|
| 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.
|
| 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.
|
| 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. Mockzilla mock: no signup, no API key.
|
| 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.
|
| 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 obtain 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.
|
| 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.
|
| 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 for committee information and Form 2 for candidate information.
|
| GET |
/candidates/totals/
|
Aggregated candidate receipts and disbursements grouped by cycle. Served by the Mockzilla mock runtime.
|
| GET |
/candidates/totals/aggregates/
|
Candidate total receipts and disbursements aggregated by aggregate_by.
|
| GET |
/candidates/totals/by_office/
|
Aggregated candidate receipts and disbursements grouped by office by cycle.
|
| GET |
/candidates/totals/by_office/by_party/
|
Aggregated candidate receipts and disbursements grouped by office by party by cycle.
|
| 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.
|
| 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. Mocked via Mockzilla.
|
| 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.
|
| 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.
|
| 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.
|
| 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.
|
| 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. Available as a Mockzilla mock endpoint.
|
| GET |
/committee/{committee_id}/reports/
|
Each report represents the summary information from 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 retrieve 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 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.
|
| 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 obtain 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.
|
| GET |
/committees/
|
Fetch basic information about committees and filers. Use parameters to filter for particular characteristics.
|
| 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.
|
| GET |
/communication_costs/aggregates/
|
Communication cost aggregated by candidate ID and committee ID. Mockzilla mock: no signup, no API key.
|
| GET |
/communication_costs/by_candidate/
|
Communication cost aggregated by candidate ID and committee ID.
|
| GET |
/communication_costs/totals/by_candidate/
|
Total communications costs aggregated across committees on supported or opposed candidates by cycle or candidate election year.
|
| GET |
/efile/filings/
|
Basic information about electronic files coming into the FEC, posted as they are received.
|
| 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.
|
| 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. Served by the Mockzilla mock runtime.
|
| 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.
|
| GET |
/election-dates/
|
FEC election dates since 1995.
|
| 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.
|
| GET |
/electioneering/aggregates/
|
Electioneering communications costs aggregates
|
| GET |
/electioneering/by_candidate/
|
Electioneering costs aggregated by candidate. Mocked via Mockzilla.
|
| GET |
/electioneering/totals/by_candidate/
|
Total electioneering communications spent on candidates by cycle or candidate election year
|
| 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 retrieve an-up-to-date list of all the candidates that filed to run for a particular seat.
|
| GET |
/elections/search/
|
List elections by cycle, office, state, and district.
|
| GET |
/elections/summary/
|
List elections by cycle, office, state, and district.
|
| 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. Available as a Mockzilla mock endpoint.
|
| GET |
/legal/search/
|
Search legal documents by document type, or across all document types using keywords, parameter values and ranges.
|
| 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.
|
| 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.
|
| 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.
|
| 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. Mockzilla mock: no signup, no API key.
|
| 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.
|
| GET |
/presidential/contributions/by_candidate/
|
Net receipts per candidate. Filter with contributor_state='US' for national totals
|
| GET |
/presidential/contributions/by_size/
|
Contribution receipts by size per candidate. Filter by candidate_id, election_year and/or size
|
| GET |
/presidential/contributions/by_state/
|
Contribution receipts by state per candidate. Filter by candidate_id and/or election_year
|
| GET |
/presidential/coverage_end_date/
|
Coverage end date per candidate. Filter by candidate_id and/or election_year. Served by the Mockzilla mock runtime.
|
| GET |
/presidential/financial_summary/
|
Financial summary per candidate. Filter by candidate_id and/or election_year
|
| 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).
|
| GET |
/reporting-dates/
|
FEC election dates since 1995.
|
| GET |
/reports/{entity_type}/
|
Each report represents the summary information from 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 retrieve 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 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.
|
| GET |
/schedules/schedule_a/
|
This description is for both /schedules/schedule_a/ and /schedules/schedule_a/{sub_id}/. This endpoint provides itemized receipts. Schedule A records describe itemized receipts, including contributions from individuals. If you are interested in contributions from an individual, use the /schedules/schedule_a/ endpoint. For a more complete description of all Schedule A records visit About receipts data. If you are interested in our "is_individual" methodology visit our methodology page. The /schedules/schedule_a/ endpoint is not paginated by page number. This endpoint uses keyset pagination to improve query performance and these indices are required to properly page through this large dataset. To request the next page, you should append the values found in the last_indexes object from pagination to the URL of your last request as additional parameters. For example, when sorting by contribution_receipt_date, you might receive a page of results with the two scenarios of following pagination information: case #1: pagination: { pages: 2152643, per_page: 20, count: 43052850, last_indexes: { last_index: "230880619", last_contribution_receipt_date: "2014-01-01" } } case #2 (results which include contribution_receipt_date = NULL): pagination: { pages: 2152644, per_page: 20, count: 43052850, last_indexes: { last_index: "230880639", sort_null_only: True } } To fetch the next page of sorted results, append last_index=230880619 and last_contribution_receipt_date=2014-01-01 to the URL and when reaching contribution_receipt_date=NULL, append last_index=230880639 and sort_null_only=True. We strongly advise paging through these results using sort indices. The default sort is acending by contribution_receipt_date (deprecated, will be descending). If you do not page using sort indices, some transactions may be unintentionally filtered out. Calls to /schedules/schedule_a/ may return many records. For large result sets, the record counts found in the pagination object are approximate; you will need to page through the records until no records are returned. To avoid throwing the "out of range" exception on the last page, one recommandation is to use total count and per_page to control the traverse loop of results. The /schedules/schedule_a/{sub_id}/ endpoint returns a single transaction, but it does include a pagination object class. Please ignore the information in that object class. Mocked via Mockzilla.
|
| GET |
/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. Unitemized individual contributions are not included.
|
| GET |
/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. Unitemized individual contributions are not included.
|
| GET |
/schedules/schedule_a/by_size/
|
This endpoint provides individual contributions received by a committee, aggregated by size: - $200 and under - $200.01 - $499.99 - $500 - $999.99 - $1000 - $1999.99 - $2000 + The $200.00 and under category includes contributions of $200 or less combined with unitemized individual contributions.
|
| GET |
/schedules/schedule_a/by_size/by_candidate/
|
This endpoint provides itemized individual contributions received by a committee, aggregated by size of contribution and candidate. If you are interested in our “is_individual” methodology, review the methodology page. Unitemized individual contributions are not included.
|
| GET |
/schedules/schedule_a/by_state/
|
This endpoint provides itemized individual contributions received by a committee, aggregated by the contributor’s state. If you are interested in our “is_individual” methodology, review the methodology page. Unitemized individual contributions are not included. Available as a Mockzilla mock endpoint.
|
| GET |
/schedules/schedule_a/by_state/by_candidate/
|
This endpoint provides itemized individual contributions received by a committee, aggregated by contributor’s state and candidate. If you are interested in our “is_individual” methodology, review the methodology page. Unitemized individual contributions are not included.
|
| GET |
/schedules/schedule_a/by_state/by_candidate/totals/
|
Itemized individual contributions aggregated by contributor’s state, candidate, committee type and cycle. If you are interested in our “is_individual” methodology, review the methodology page. Unitemized individual contributions are not included.
|
| GET |
/schedules/schedule_a/by_state/totals/
|
This endpoint provides itemized individual contributions received by a committee, aggregated by contributor’s state, committee type and cycle. If you are interested in our “is_individual” methodology, review the methodology page. Unitemized individual contributions are not included.
|
| GET |
/schedules/schedule_a/by_zip/
|
This endpoint provides itemized individual contributions received by a committee, aggregated by the contributor’s ZIP code. If you are interested in our “is_individual” methodology, review the methodology page. Unitemized individual contributions are not included.
|
| GET |
/schedules/schedule_a/efile/
|
Efiling endpoints provide real-time campaign finance data received from electronic filers. Efiling endpoints only contain the most recent four months of data and don't contain the processed and coded data that you can find on other endpoints. Mockzilla mock: no signup, no API key.
|
| GET |
/schedules/schedule_a/{sub_id}/
|
This description is for both /schedules/schedule_a/ and /schedules/schedule_a/{sub_id}/. This endpoint provides itemized receipts. Schedule A records describe itemized receipts, including contributions from individuals. If you are interested in contributions from an individual, use the /schedules/schedule_a/ endpoint. For a more complete description of all Schedule A records visit About receipts data. If you are interested in our "is_individual" methodology visit our methodology page. The /schedules/schedule_a/ endpoint is not paginated by page number. This endpoint uses keyset pagination to improve query performance and these indices are required to properly page through this large dataset. To request the next page, you should append the values found in the last_indexes object from pagination to the URL of your last request as additional parameters. For example, when sorting by contribution_receipt_date, you might receive a page of results with the two scenarios of following pagination information: case #1: pagination: { pages: 2152643, per_page: 20, count: 43052850, last_indexes: { last_index: "230880619", last_contribution_receipt_date: "2014-01-01" } } case #2 (results which include contribution_receipt_date = NULL): pagination: { pages: 2152644, per_page: 20, count: 43052850, last_indexes: { last_index: "230880639", sort_null_only: True } } To fetch the next page of sorted results, append last_index=230880619 and last_contribution_receipt_date=2014-01-01 to the URL and when reaching contribution_receipt_date=NULL, append last_index=230880639 and sort_null_only=True. We strongly advise paging through these results using sort indices. The default sort is acending by contribution_receipt_date (deprecated, will be descending). If you do not page using sort indices, some transactions may be unintentionally filtered out. Calls to /schedules/schedule_a/ may return many records. For large result sets, the record counts found in the pagination object are approximate; you will need to page through the records until no records are returned. To avoid throwing the "out of range" exception on the last page, one recommandation is to use total count and per_page to control the traverse loop of results. The /schedules/schedule_a/{sub_id}/ endpoint returns a single transaction, but it does include a pagination object class. Please ignore the information in that object class.
|
| 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.
|
| 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. Inspect the disbursement_purpose sql function within the migrations for more details.
|
| GET |
/schedules/schedule_b/by_recipient/
|
Schedule B disbursements aggregated by recipient name. To avoid double counting, memoed items are not included.
|
| 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. Served by the Mockzilla mock runtime.
|
| GET |
/schedules/schedule_b/efile/
|
Efiling endpoints provide real-time campaign finance data received from electronic filers. Efiling endpoints only contain the most recent four months of data and don't contain the processed and coded data that you can find on other endpoints.
|
| 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.
|
| 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.
|
| 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.
|
| GET |
/schedules/schedule_d/
|
Schedule D, it shows debts and obligations owed to or by the committee that are required to be disclosed. Mocked via Mockzilla.
|
| 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.
|
| 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.
|
| GET |
/schedules/schedule_e/by_candidate/
|
Schedule E receipts aggregated by recipient candidate. To avoid double counting, memoed items are not included.
|
| GET |
/schedules/schedule_e/efile/
|
Efiling endpoints provide real-time campaign finance data received from electronic filers. Efiling endpoints only contain the most recent four months of data and don't contain the processed and coded data that you can find on other endpoints.
|
| GET |
/schedules/schedule_e/totals/by_candidate/
|
Total independent expenditure on supported or opposed candidates by cycle or candidate election year. Available as a Mockzilla mock endpoint.
|
| 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.
|
| 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.
|
| 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.
|
| 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 that creates these calculations.
|
| GET |
/totals/inaugural_committees/by_contributor/
|
This endpoint provides information about an inaugural committee's Form 13 report of donations accepted. The data is aggregated by the contributor and the two-year period. We refer to two-year periods as a cycle. Mockzilla mock: no signup, no API key.
|
| GET |
/totals/{entity_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 obtain 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.
|