OpenFEC

Tools (93)

Extracted live via the executor SDK.

• audit.getAuditCase

  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.

• audit.getAuditCategory

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

• audit.getAuditPrimaryCategory

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

• audit.getNamesAuditCandidates

  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.

• audit.getNamesAuditCommittees

  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.

• candidate.getCandidateCandidateId

  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.

• candidate.getCandidateCandidateIdHistory

  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.

• candidate.getCandidateCandidateIdHistoryCycle

  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.

• candidate.getCandidateCandidateIdTotals

  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.

• candidate.getCandidates

  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.

• candidate.getCandidatesSearch

  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.

• candidate.getCandidatesTotals

  Aggregated candidate receipts and disbursements grouped by cycle.

• candidate.getCandidatesTotalsAggregates

  Candidate total receipts and disbursements aggregated by aggregate_by.

• candidate.getCandidatesTotalsByOffice

  Aggregated candidate receipts and disbursements grouped by office by cycle.

• candidate.getCandidatesTotalsByOfficeByParty

  Aggregated candidate receipts and disbursements grouped by office by party by cycle.

• candidate.getCommitteeCommitteeIdCandidates

  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.

• candidate.getCommitteeCommitteeIdCandidatesHistory

  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.

• candidate.getCommitteeCommitteeIdCandidatesHistoryCycle

  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.

• committee.getCandidateCandidateIdCommittees

  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.

• committee.getCandidateCandidateIdCommitteesHistory

  Explore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or committee_type.

• committee.getCandidateCandidateIdCommitteesHistoryCycle

  Explore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or committee_type.

• committee.getCommitteeCommitteeId

  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.

• committee.getCommitteeCommitteeIdHistory

  Explore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or committee_type.

• committee.getCommitteeCommitteeIdHistoryCycle

  Explore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or committee_type.

• committee.getCommittees

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

• communicationCost.getCommunicationCosts

  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.

• communicationCost.getCommunicationCostsAggregates

  Communication cost aggregated by candidate ID and committee ID.

• communicationCost.getCommunicationCostsByCandidate

  Communication cost aggregated by candidate ID and committee ID.

• communicationCost.getCommunicationCostsTotalsByCandidate

  Total communications costs aggregated across committees on supported or opposed candidates by cycle or candidate election year.

• dates.getCalendarDates

  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.

• dates.getCalendarDatesExport

  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.

• dates.getElectionDates

  FEC election dates since 1995.

• dates.getReportingDates

  FEC election dates since 1995.

• debts.getSchedulesScheduleD

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

• debts.getSchedulesScheduleDSubId

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

• disbursements.getSchedulesScheduleB

  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.

• disbursements.getSchedulesScheduleBByPurpose

  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.

• disbursements.getSchedulesScheduleBByRecipient

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

• disbursements.getSchedulesScheduleBByRecipientId

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

• disbursements.getSchedulesScheduleBEfile

  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.

• disbursements.getSchedulesScheduleBSubId

  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.

• efiling.getEfileFilings

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

• efiling.getEfileReportsHouseSenate

  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.

• efiling.getEfileReportsPacParty

  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.

• efiling.getEfileReportsPresidential

  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.

• electioneering.getElectioneering

  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.

• electioneering.getElectioneeringAggregates

  Electioneering communications costs aggregates

• electioneering.getElectioneeringByCandidate

  Electioneering costs aggregated by candidate

• electioneering.getElectioneeringTotalsByCandidate

  Total electioneering communications spent on candidates by cycle or candidate election year

• filerResources.getRadAnalyst

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

• filerResources.getStateElectionOffice

  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.

• filings.getCandidateCandidateIdFilings

  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.

• filings.getCommitteeCommitteeIdFilings

  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.

• filings.getFilings

  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.

• filings.getOperationsLog

  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.

• financial.getCommitteeCommitteeIdReports

  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.

• financial.getCommitteeCommitteeIdTotals

  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.

• financial.getElections

  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.

• financial.getElectionsSearch

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

• financial.getElectionsSummary

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

• financial.getReportsEntityType

  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.

• financial.getTotalsByEntity

  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.

• financial.getTotalsEntityType

  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.

• independentExpenditures.getSchedulesScheduleE

  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.

• independentExpenditures.getSchedulesScheduleEByCandidate

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

• independentExpenditures.getSchedulesScheduleEEfile

  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.

• independentExpenditures.getSchedulesScheduleETotalsByCandidate

  Total independent expenditure on supported or opposed candidates by cycle or candidate election year.

• legal.getLegalSearch

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

• loans.getSchedulesScheduleC

  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.

• loans.getSchedulesScheduleCSubId

  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.

• partyCoordinatedExpenditures.getSchedulesScheduleF

  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.

• partyCoordinatedExpenditures.getSchedulesScheduleFSubId

  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.

• presidential.getPresidentialContributionsByCandidate

  Net receipts per candidate.

  Filter with contributor_state='US' for national totals

• presidential.getPresidentialContributionsBySize

  Contribution receipts by size per candidate.

  Filter by candidate_id, election_year and/or size

• presidential.getPresidentialContributionsByState

  Contribution receipts by state per candidate.

  Filter by candidate_id and/or election_year

• presidential.getPresidentialCoverageEndDate

  Coverage end date per candidate.

  Filter by candidate_id and/or election_year

• presidential.getPresidentialFinancialSummary

  Financial summary per candidate.

  Filter by candidate_id and/or election_year

• receipts.getSchedulesScheduleA

  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.

• receipts.getSchedulesScheduleAByEmployer

  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.

• receipts.getSchedulesScheduleAByOccupation

  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.

• receipts.getSchedulesScheduleABySize

  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.

• receipts.getSchedulesScheduleABySizeByCandidate

  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.

• receipts.getSchedulesScheduleAByState

  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.

• receipts.getSchedulesScheduleAByStateByCandidate

  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.

• receipts.getSchedulesScheduleAByStateByCandidateTotals

  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.

• receipts.getSchedulesScheduleAByStateTotals

  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.

• receipts.getSchedulesScheduleAByZip

  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.

• receipts.getSchedulesScheduleAEfile

  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.

• receipts.getSchedulesScheduleASubId

  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.

• search.getNamesCandidates

  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.

• search.getNamesCommittees

  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.

• openapi.previewSpec

  Preview an OpenAPI document before adding it as a source

• openapi.addSource

  Add an OpenAPI source and register its operations as tools