openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 662 kB
JSON
{"openapi":"3.0.0","info":{"contact":{"x-twitter":"FEC"},"description":"This API allows you to explore the way candidates and committees fund their campaigns. \n\n The FEC API is a RESTful web service supporting full-text and field-specific searches on FEC data. [Bulk downloads](https://www.fec.gov/data/advanced/?tab=bulk-data) are available on the current site. Information is tied to the underlying forms by file ID and image ID. Data is updated nightly. \n\n There is a lot of data, but a good place to start is to use search to find interesting candidates and committees. Then, you can use their IDs to find report or line item details with the other endpoints. If you are interested in individual donors, check out contributor information in schedule_a. \n\n Get an [API key here](https://api.data.gov/signup/). That will enable you to place up to 1,000 calls an hour. Each call is limited to 100 results per page. You can email questions, comments or a request to get a key for 120 calls per minute to [APIinfo@fec.gov](mailto:apiinfo@fec.gov). You can also ask questions and discuss the data in the [FEC data Google Group](https://groups.google.com/forum/#!forum/fec-data). API changes will also be added to this group in advance of the change. \n\n \n\n The model definitions and schema are available at [/swagger](/swagger/). This is useful for making wrappers and exploring the data. \n\n A few restrictions limit the way you can use FEC data. For example, you can’t use contributor lists for commercial purposes or to solicit donations. [Learn more here](https://www.fec.gov/updates/sale-or-use-contributor-information/). \n\n [View our source code](https://github.com/fecgov/openFEC). We welcome issues and pull requests!","title":"OpenFEC","version":"1.0","x-apisguru-categories":["open_data"],"x-logo":{"url":"https://twitter.com/FEC/profile_image?size=original"},"x-origin":[{"format":"swagger","url":"https://api.open.fec.gov/swagger/","version":"2.0"}],"x-providerName":"fec.gov"},"security":[{"apiKey":[]}],"tags":[{"description":"Candidate endpoints give you access to information about the people running for office. This information is organized by candidate_id. If you're unfamiliar with candidate IDs, using `/candidates/search` will help you locate a particular candidate. \n\n Officially, a candidate is an individual seeking nomination for election to a federal office. People become candidates when they (or agents working on their behalf) raise contributions or make expenditures that exceed $5,000. \n\n 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 committee information.","name":"candidate"},{"description":"Committees are entities that spend and raise money in an election. Their characteristics and relationships with candidates can change over time. \n\n You might want to use filters or search endpoints to find the committee you're looking for. Then you can use other committee endpoints to explore information about the committee that interests you. \n\n Financial information is organized by `committee_id`, so finding the committee you're interested in will lead you to more granular financial information. \n\n The committee endpoints include all FEC filers, even if they aren't registered as a committee. \n\n Officially, committees include the committees and organizations that file with the FEC. Several different types of organizations file financial reports with the FEC: \n\n *Campaign committees authorized by particular candidates to raise and spend funds in their campaigns. Non-party committees (e.g., PACs), some of which may be sponsored by corporations, unions, trade or membership groups, etc. Political party committees at the national, state, and local levels. Groups and individuals making only independent expenditures Corporations, unions, and other organizations making internal communications* \n\n The committee endpoints primarily use data from FEC registration Form 1 and Form 2.","name":"committee"},{"description":"Reporting deadlines, election dates FEC meetings, events etc.","name":"dates"},{"description":"Fetch key information about a committee's Form 3, Form 3X, or Form 3P financial reports. \n\n Most committees are required to summarize their financial activity in each filing; those summaries are included in these files. 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. \n\n Information is made available on the API as soon as it's processed. Keep in mind, complex paper filings take longer to process. \n\n The financial endpoints use data from FEC [form 5](http://www.fec.gov/pdf/forms/fecfrm5.pdf), for independent expenditors; or the summary and detailed summary pages of the FEC [Form 3](http://www.fec.gov/pdf/forms/fecfrm3.pdf), for House and Senate committees; [Form 3X](http://www.fec.gov/pdf/forms/fecfrm3x.pdf), for PACs and parties; and [Form 3P](http://www.fec.gov/pdf/forms/fecfrm3p.pdf), for presidential committees.","name":"financial"},{"description":"Search for candidates, committees by name.","name":"search"},{"description":"All official records and reports filed by or delivered to the FEC. \n\n 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.","name":"filings"},{"description":"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. \n\n 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. \n\n 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. \n\n 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. \n\n For the Schedule A aggregates, such as by_occupation and by_state, include only unique individual contributions. See below for full methodology. \n\n __Methodology for determining unique, individual contributions__ \n\n For receipts over $200 use FEC code line_number to identify individuals. \n\n The line numbers that specify individuals that are automatically included: \n\n 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 \n\n 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. \n\n 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 \n\n 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.","name":"receipts"},{"description":"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.","name":"disbursements"},{"description":"Schedule C shows all loans, endorsements and loan guarantees a committee receives or makes.","name":"loans"},{"description":"Schedule D, it shows debts and obligations owed to or by the committee that are required to be disclosed.","name":"debts"},{"description":"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. \n\n 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.\" \n\n 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/`.","name":"independent expenditures"},{"description":"Schedule F, it shows all special expenditures a national or state party committee makes in connection with the general election campaigns of federal candidates.","name":"party-coordinated expenditures"},{"description":"Reports of communication costs by corporations and membership organizations from the FEC [F7 forms](http://www.fec.gov/pdf/forms/fecform7.pdf).","name":"communication cost"},{"description":"An electioneering communication is any broadcast, cable or satellite communication that fulfills each of the following conditions: \n\n _The communication refers to a clearly identified federal candidate._ \n\n _The communication is publicly distributed by a television station, radio station, cable television system or satellite system for a fee._ \n\n _The communication is distributed within 60 days prior to a general election or 30 days prior to a primary election to federal office._","name":"electioneering"},{"description":"Useful tools for those who file with the FEC. \n\n Look up RAD analyst with telephone extension by committee_id.","name":"filer resources"},{"description":"Efiling endpoints provide real-time campaign finance data for electronic filers. \n\n 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. \n\n 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. \n\n 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.","name":"efiling"},{"description":"The agency’s monitoring process may detect potential violations through a review of a committee’s reports or through a Commission audit. By law, all enforcement cases must remain confidential until they’re closed. \n\n The Commission is required by law to audit Presidential campaigns that accept public funds. In addition, the Commission audits a committee when it appears not to have met the threshold requirements for substantial compliance with the Federal Election Campaign Act. The audit determines whether the committee complied with limitations, prohibitions and disclosure requirements. \n\n These endpoints contain Final Audit Reports approved by the Commission since inception.","name":"audit"},{"description":"Explore relevant statutes, regulations and Commission actions.","name":"legal"}],"paths":{"/audit-case/":{"get":{"description":"\nThis endpoint contains Final Audit Reports approved by the Commission since inception.\nThe search can be based on information about the audited committee (Name, FEC ID Number, Type, \nElection Cycle) or the issues covered in the report.\n","parameters":[{"description":"\nAudit category ID (table PK)\n","in":"query","name":"primary_category_id","required":false,"schema":{"type":"string","default":"all"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nFilter records to only those that are applicable to a given two-year\nperiod. This cycle follows the traditional House election cycle and\nsubdivides the presidential and Senate elections into comparable\ntwo-year blocks. The cycle begins with an odd year and is named for its\nending, even year.\n","in":"query","name":"max_election_cycle","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"\nThe finding id of an audit. Finding are a category of broader issues. Each category has an unique ID.\n","in":"query","name":"sub_category_id","required":false,"schema":{"type":"string","default":"all"}},{"description":"The one-letter type code of the organization:\n - C communication cost\n - D delegate\n - E electioneering communication\n - H House\n - I independent expenditor (person or group)\n - N PAC - nonqualified\n - O independent expenditure-only (super PACs)\n - P presidential\n - Q PAC - qualified\n - S Senate\n - U single candidate independent expenditure\n - V PAC with non-contribution account, nonqualified\n - W PAC with non-contribution account, qualified\n - X party, nonqualified\n - Y party, qualified\n - Z national party non-federal account\n","in":"query","name":"committee_type","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"The name of the committee. If a committee changes its name, the most recent name will be shown. Committee names are not unique. Use committee_id for looking up records.","in":"query","name":"q","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"\nFilter records to only those that are applicable to a given two-year\nperiod. This cycle follows the traditional House election cycle and\nsubdivides the presidential and Senate elections into comparable\ntwo-year blocks. The cycle begins with an odd year and is named for its\nending, even year.\n","in":"query","name":"cycle","required":false,"explode":true,"schema":{"type":"array","items":{"format":"int32","type":"integer"}}},{"description":"\nA unique identifier assigned to each committee or filer registered with the FEC. In general committee id's begin with the letter C which is followed by eight digits.\n","in":"query","name":"committee_id","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"\nA unique identifier assigned to each candidate registered with the FEC.\nIf a person runs for several offices, that person will have separate candidate IDs for each office.\n","in":"query","name":"candidate_id","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"\nFilter records to only those that are applicable to a given two-year\nperiod. This cycle follows the traditional House election cycle and\nsubdivides the presidential and Senate elections into comparable\ntwo-year blocks. The cycle begins with an odd year and is named for its\nending, even year.\n","in":"query","name":"min_election_cycle","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"Provide a field to sort by. Use - for descending order.","in":"query","name":"sort","required":false,"x-nullable":true,"explode":true,"schema":{"type":"array","items":{"type":"string"},"default":["-cycle","committee_name"]}},{"description":"Name of candidate running for office","in":"query","name":"qq","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"\nPrimary/foreign key for audit tables\n","in":"query","name":"audit_case_id","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"type":"boolean","default":false}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"type":"string","default":"DEMO_KEY"}},{"description":"Type of committee:\n - H or S - Congressional\n - P - Presidential\n - X or Y or Z - Party\n - N or Q - PAC\n - I - Independent expenditure\n - O - Super PAC \n","in":"query","name":"committee_designation","required":false,"schema":{"type":"string"}},{"description":"\nThe audit issue. Each subcategory has an unique ID\n","in":"query","name":"audit_id","required":false,"explode":true,"schema":{"type":"array","items":{"format":"int32","type":"integer"}}}],"responses":{"default":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditCasePage"}}}}},"tags":["audit"]}},"/audit-category/":{"get":{"description":"\nThis lists the options for the categories and subcategories available in the /audit-search/ endpoint.\n","parameters":[{"description":"\nAudit category ID (table PK)\n","in":"query","name":"primary_category_id","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Provide a field to sort by. Use - for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string","default":"primary_category_name"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"type":"boolean","default":false}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"type":"string","default":"DEMO_KEY"}},{"description":"Primary Audit Category\n - No Findings or Issues/Not a Committee\n - Net Outstanding Campaign/Convention Expenditures/Obligations\n - Payments/Disgorgements\n - Allocation Issues\n - Prohibited Contributions\n - Disclosure\n - Recordkeeping\n - Repayment to US Treasury\n - Other\n - Misstatement of Financial Activity\n - Excessive Contributions\n - Failure to File Reports/Schedules/Notices\n - Loans\n - Referred Findings Not Listed\n","in":"query","name":"primary_category_name","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}}],"responses":{"default":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditCategoryPage"}}}}},"tags":["audit"]}},"/audit-primary-category/":{"get":{"description":"\nThis lists the options for the primary categories available in the /audit-search/ endpoint.\n","parameters":[{"description":"\nAudit category ID (table PK)\n","in":"query","name":"primary_category_id","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Provide a field to sort by. Use - for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string","default":"primary_category_name"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"type":"boolean","default":false}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"type":"string","default":"DEMO_KEY"}},{"description":"Primary Audit Category\n - No Findings or Issues/Not a Committee\n - Net Outstanding Campaign/Convention Expenditures/Obligations\n - Payments/Disgorgements\n - Allocation Issues\n - Prohibited Contributions\n - Disclosure\n - Recordkeeping\n - Repayment to US Treasury\n - Other\n - Misstatement of Financial Activity\n - Excessive Contributions\n - Failure to File Reports/Schedules/Notices\n - Loans\n - Referred Findings Not Listed\n","in":"query","name":"primary_category_name","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}}],"responses":{"default":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditPrimaryCategoryPage"}}}}},"tags":["audit"]}},"/calendar-dates/":{"get":{"description":"\nCombines the election and reporting dates with Commission meetings, conferences, outreach, Advisory Opinions, rules, litigation dates and other\nevents into one calendar.\n\nState and report type filtering is no longer available.\n","parameters":[{"description":"\nEach type of event has a calendar category with an integer id. Options are: Open Meetings: 32, Executive Sessions: 39, Public Hearings: 40,\nConferences: 33, Roundtables: 34, Election Dates: 36, Federal Holidays: 37, FEA Periods: 38, Commission Meetings: 20,\nReporting Deadlines: 21, Conferences and Outreach: 22, AOs and Rules: 23, Other: 24, Quarterly: 25, Monthly: 26,\nPre and Post-Elections: 27, EC Periods:28, and IE Periods: 29\n","in":"query","name":"calendar_category_id","required":false,"explode":true,"schema":{"type":"array","items":{"format":"int32","type":"integer"}}},{"description":"Provide a field to sort by. Use - for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string","default":"-start_date"}},{"description":"\nThe minimum start date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"min_start_date","required":false,"schema":{"type":"string","format":"date"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"An unique ID for an event. Useful for downloading a single event to your calendar. This ID is not a permanent, persistent ID.","in":"query","name":"event_id","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"Brief description of event","in":"query","name":"description","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Longer description of event","in":"query","name":"summary","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"type":"boolean","default":false}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nThe minimum end date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"min_end_date","required":false,"schema":{"type":"string","format":"date"}},{"description":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"type":"string","default":"DEMO_KEY"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"\nThe maximum start date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"max_start_date","required":false,"schema":{"type":"string","format":"date"}},{"description":"\nThe maximum end date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"max_end_date","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"default":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarDatePage"}}}}},"tags":["dates"]}},"/calendar-dates/export/":{"get":{"description":"\nReturns CSV or ICS for downloading directly into calendar applications like Google, Outlook or other applications.\n\nCombines the election and reporting dates with Commission meetings, conferences, outreach, Advisory Opinions, rules, litigation dates and other\nevents into one calendar.\n\nState filtering now applies to elections, reports and reporting periods.\n\nPresidential pre-primary report due dates are not shown on even years.\nFilers generally opt to file monthly rather than submit over 50 pre-primary election\nreports. All reporting deadlines are available at /reporting-dates/ for reference.\n\nThis is [the sql function](https://github.com/fecgov/openFEC/blob/develop/data/migrations/V40__omnibus_dates.sql)\nthat creates the calendar.\n\n","parameters":[{"description":"\nEach type of event has a calendar category with an integer id. Options are: Open Meetings: 32, Executive Sessions: 39, Public Hearings: 40,\nConferences: 33, Roundtables: 34, Election Dates: 36, Federal Holidays: 37, FEA Periods: 38, Commission Meetings: 20,\nReporting Deadlines: 21, Conferences and Outreach: 22, AOs and Rules: 23, Other: 24, Quarterly: 25, Monthly: 26,\nPre and Post-Elections: 27, EC Periods:28, and IE Periods: 29\n","in":"query","name":"calendar_category_id","required":false,"explode":true,"schema":{"type":"array","items":{"format":"int32","type":"integer"}}},{"description":"Provide a field to sort by. Use - for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string","default":"-start_date"}},{"description":"\nThe minimum start date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"min_start_date","required":false,"schema":{"type":"string","format":"date"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"An unique ID for an event. Useful for downloading a single event to your calendar. This ID is not a permanent, persistent ID.","in":"query","name":"event_id","required":false,"schema":{"type":"integer","format":"int32"}},{"in":"query","name":"renderer","required":false,"schema":{"type":"string","enum":["ics","csv"],"default":"ics"}},{"description":"Brief description of event","in":"query","name":"description","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Longer description of event","in":"query","name":"summary","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"type":"boolean","default":false}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nThe minimum end date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"min_end_date","required":false,"schema":{"type":"string","format":"date"}},{"description":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"type":"string","default":"DEMO_KEY"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"\nThe maximum start date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"max_start_date","required":false,"schema":{"type":"string","format":"date"}},{"description":"\nThe maximum end date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"max_end_date","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"default":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarDatePage"}}}}},"tags":["dates"]}},"/candidate/{candidate_id}/":{"get":{"description":"\nThis endpoint is useful for finding detailed information about a particular candidate. Use the\n`candidate_id` to find the most recent information about that candidate.\n\n","parameters":[{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"A boolean the describes if a presidential candidate has accepted federal funds. The flag will be false for House and Senate candidates.","in":"query","name":"federal_funds_flag","required":false,"schema":{"type":"boolean"}},{"description":"US state or territory where a candidate runs for office","in":"query","name":"state","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"One-letter code explaining if the candidate is:\n - C present candidate\n - F future candidate\n - N not yet a candidate\n - P prior candidate\n","in":"query","name":"candidate_status","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["","C","F","N","P"],"type":"string"}}},{"description":"\nTwo-year election cycle in which a candidate runs for office.\nCalculated from FEC Form 2. The cycle begins with\nan odd year and is named for its ending, even year. This cycle follows\nthe traditional house election cycle and subdivides the presidential\nand Senate elections into comparable two-year blocks. To see data for\nthe entire four years of a presidential term or six years of a senatorial term,\nyou will need the `election_full` flag.\n","in":"query","name":"cycle","required":false,"explode":true,"schema":{"type":"array","items":{"format":"int32","type":"integer"}}},{"description":"Provide a field to sort by. Use - for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string","default":"name"}},{"description":"See records pertaining to a particular election year. The list of election years is based on a candidate filing a statement of candidacy (F2) for that year.","in":"query","name":"year","required":false,"schema":{"type":"string"}},{"description":"Two-digit US House distirict of the office the candidate is running for. Presidential, Senate and House at-large candidates will have District 00.","in":"query","name":"district","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Federal office candidate runs for: H, S or P","in":"query","name":"office","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["","H","S","P"],"type":"string"}}},{"description":"One-letter code ('I', 'C', 'O') explaining if the candidate is an incumbent, a challenger, or if the seat is open.","in":"query","name":"incumbent_challenge","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["","I","C","O"],"type":"string"}}},{"description":"A boolean that describes if a candidate's committee has ever received any receipts for their campaign for this particular office. (Candidates have separate candidate IDs for each office.)","in":"query","name":"has_raised_funds","required":false,"schema":{"type":"boolean"}},{"description":"Name (candidate or committee) to search for. Alias for 'q'.","in":"query","name":"name","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"type":"boolean","default":false}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"type":"string","default":"DEMO_KEY"}},{"description":"Year of election","in":"query","name":"election_year","required":false,"explode":true,"schema":{"type":"array","items":{"format":"int32","type":"integer"}}},{"description":"Three-letter code for the party affiliated with a candidate or committee. For example, DEM for Democratic Party and REP for Republican Party.","in":"query","name":"party","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"\nA unique identifier assigned to each candidate registered with the FEC.\nIf a person runs for several offices, that person will have separate candidate IDs for each office.\n","in":"path","name":"candidate_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateDetailPage"}}}}},"tags":["candidate"]}},"/candidate/{candidate_id}/committees/":{"get":{"description":"\nThis endpoint is useful for finding detailed information about a particular committee or\nfiler. Use the `committee_id` to find the most recent information about the committee.\n","parameters":[{"description":"\nA two year election cycle that the committee was active- (after original registration\ndate but before expiration date in FEC Form 1s) The cycle begins with\nan odd year and is named for its ending, even year.\n","in":"query","name":"cycle","required":false,"explode":true,"schema":{"type":"array","items":{"format":"int32","type":"integer"}}},{"description":"Provide a field to sort by. Use - for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string","default":"name"}},{"description":"A year that the committee was active— (after original registration date or filing but before expiration date)","in":"query","name":"year","required":false,"explode":true,"schema":{"type":"array","items":{"format":"int32","type":"integer"}}},{"description":"The one-letter code for the kind for organization:\n - C corporation\n - L labor organization\n - M membership organization\n - T trade association\n - V cooperative\n - W corporation without capital stock\n","in":"query","name":"organization_type","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["","C","L","M","T","V","W"],"type":"string"}}},{"description":"The one-letter \n code of the filing frequency:\n - A Administratively terminated\n - D Debt\n - M Monthly filer\n - Q Quarterly filer\n - T Terminated\n - W Waived\n","in":"query","name":"filing_frequency","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["","A","M","N","Q","T","W","-A","-T"],"type":"string"}}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"The one-letter type code of the organization:\n - C communication cost\n - D delegate\n - E electioneering communication\n - H House\n - I independent expenditor (person or group)\n - N PAC - nonqualified\n - O independent expenditure-only (super PACs)\n - P presidential\n - Q PAC - qualified\n - S Senate\n - U single candidate independent expenditure\n - V PAC with non-contribution account, nonqualified\n - W PAC with non-contribution account, qualified\n - X party, nonqualified\n - Y party, qualified\n - Z national party non-federal account\n","in":"query","name":"committee_type","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["","C","D","E","H","I","N","O","P","Q","S","U","V","W","X","Y","Z"],"type":"string"}}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"type":"boolean","default":false}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"type":"string","default":"DEMO_KEY"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"The one-letter designation code of the organization:\n - A authorized by a candidate\n - J joint fundraising committee\n - P principal campaign committee of a candidate\n - U unauthorized\n - B lobbyist/registrant PAC\n - D leadership PAC\n","in":"query","name":"designation","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["","A","J","P","U","B","D"],"type":"string"}}},{"description":"\nA unique identifier assigned to each candidate registered with the FEC.\nIf a person runs for several offices, that person will have separate candidate IDs for each office.\n","in":"path","name":"candidate_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitteeDetailPage"}}}}},"tags":["committee"]}},"/candidate/{candidate_id}/committees/history/":{"get":{"description":"\nExplore a filer's characteristics over time. This can be particularly useful if the\ncommittees change treasurers, designation, or `committee_type`.\n","parameters":[{"description":"Aggregate values over full election period","in":"query","name":"election_full","required":false,"schema":{"type":"boolean","default":false}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"type":"boolean","default":false}},{"description":"Provide a field to sort by. Use - for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string","default":"-cycle"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"type":"string","default":"DEMO_KEY"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"\nA unique identifier assigned to each candidate registered with the FEC.\nIf a person runs for several offices, that person will have separate candidate IDs for each office.\n","in":"path","name":"candidate_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitteeHistoryPage"}}}}},"tags":["committee"]}},"/candidate/{candidate_id}/committees/history/{cycle}/":{"get":{"description":"\nExplore a filer's characteristics over time. This can be particularly useful if the\ncommittees change treasurers, designation, or `committee_type`.\n","parameters":[{"description":"Aggregate values over full election period","in":"query","name":"election_full","required":false,"schema":{"type":"boolean","default":false}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"type":"boolean","default":false}},{"description":"Provide a field to sort by. Use - for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string","default":"-cycle"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"type":"string","default":"DEMO_KEY"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"\nA two year election cycle that the committee was active- (after original registration\ndate but before expiration date in FEC Form 1s) The cycle begins with\nan odd year and is named for its ending, even year.\n","in":"path","name":"cycle","required":true,"schema":{"type":"integer","format":"int32"}},{"description":"\nA unique identifier assigned to each candidate registered with the FEC.\nIf a person runs for several offices, that person will have separate candidate IDs for each office.\n","in":"path","name":"candidate_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitteeHistoryPage"}}}}},"tags":["committee"]}},"/candidate/{candidate_id}/filings/":{"get":{"description":"\nAll official records and reports filed by or delivered to the FEC.\n\nNote: because the filings data includes many records, counts for large\nresult sets are approximate; you will want to page through the records until no records are returned.\n","parameters":[{"description":"\nThe type of document for documents other than reports:\n - 2 24 Hour Contribution Notice\n - 4 48 Hour Contribution Notice\n - A Debt Settlement Statement\n - B Acknowledgment of Receipt of Debt Settlement Statement\n - C RFAI: Debt Settlement First Notice\n - D Commission Debt Settlement Review\n - E Commission Response TO Debt Settlement Request\n - F Administrative Termination\n - G Debt Settlement Plan Amendment\n - H Disavowal Notice\n - I Disavowal Response\n - J Conduit Report\n - K Termination Approval\n - L Repeat Non-Filer Notice\n - M Filing Frequency Change Notice\n - N Paper Amendment to Electronic Report\n - O Acknowledgment of Filing Frequency Change\n - S RFAI: Debt Settlement Second\n - T Miscellaneous Report TO FEC\n - V Repeat Violation Notice (441A OR 441B)\n - P Notice of Paper Filing\n - R F3L Filing Frequency Change Notice\n - Q Acknowledgment of F3L Filing Frequency Change\n - U Unregistered Committee Notice\n","in":"query","name":"document_type","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"type":"boolean","default":false}},{"description":"\nIndicates the type of form that was filed.\nex: F1, F2, F3P, F3X etc...\n","in":"query","name":"form_type","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Name of report where the underlying data comes from:\n - 10D Pre-Election\n - 10G Pre-General\n - 10P Pre-Primary\n - 10R Pre-Run-Off\n - 10S Pre-Special\n - 12C Pre-Convention\n - 12G Pre-General\n - 12P Pre-Primary\n - 12R Pre-Run-Off\n - 12S Pre-Special\n - 30D Post-Election\n - 30G Post-General\n - 30P Post-Primary\n - 30R Post-Run-Off\n - 30S Post-Special\n - 60D Post-Convention\n - M1 January Monthly\n - M10 October Monthly\n - M11 November Monthly\n - M12 December Monthly\n - M2 February Monthly\n - M3 March Monthly\n - M4 April Monthly\n - M5 May Monthly\n - M6 June Monthly\n - M7 July Monthly\n - M8 August Monthly\n - M9 September Monthly\n - MY Mid-Year Report\n - Q1 April Quarterly\n - Q2 July Quarterly\n - Q3 October Quarterly\n - TER Termination Report\n - YE Year-End\n - ADJ COMP ADJUST AMEND\n - CA COMPREHENSIVE AMEND\n - 90S Post Inaugural Supplement\n - 90D Post Inaugural\n - 48 48 Hour Notification\n - 24 24 Hour Notification\n - M7S July Monthly/Semi-Annual\n - MSA Monthly Semi-Annual (MY)\n - MYS Monthly Year End/Semi-Annual\n - Q2S July Quarterly/Semi-Annual\n - QSA Quarterly Semi-Annual (MY)\n - QYS Quarterly Year End/Semi-Annual\n - QYE Quarterly Semi-Annual (YE)\n - QMS Quarterly Mid-Year/ Semi-Annual\n - MSY Monthly Semi-Annual (YE)\n","in":"query","name":"report_type","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"The one-letter type code of the organization:\n - C communication cost\n - D delegate\n - E electioneering communication\n - H House\n - I independent expenditor (person or group)\n - N PAC - nonqualified\n - O independent expenditure-only (super PACs)\n - P presidential\n - Q PAC - qualified\n - S Senate\n - U single candidate independent expenditure\n - V PAC with non-contribution account, nonqualified\n - W PAC with non-contribution account, qualified\n - X party, nonqualified\n - Y party, qualified\n - Z national party non-federal account\n","in":"query","name":"committee_type","required":false,"schema":{"type":"string"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"description":"Requests for additional information (RFAIs) sent to filers. The request type is based on the type of document filed:\n - 1 Statement of Organization\n