openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 796 kB
JSON
{"openapi":"3.0.0","servers":[{"url":"/v1"}],"info":{"contact":{"x-twitter":"FEC"},"description":"This application programming interface (API) allows you to explore the way candidates and committees fund their campaigns. \n\n The Federal Election Commission (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 are a lot of data, and 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 the `/schedule_a/` endpoints. \n\n <b class=\"body\" id=\"getting_started_head\">Getting started with the openFEC API</b><br> \n\n If you would like to use the FEC's API programmatically, you can sign up for your own API key using our form. Alternatively, you can still try out our API without an API key by using the web interface and using DEMO_KEY. Note that when you use the openFEC API you are subject to the [Terms of Service](https://github.com/fecgov/FEC/blob/master/TERMS-OF-SERVICE.md) and [Acceptable Use policy](https://github.com/fecgov/FEC/blob/master/ACCEPTABLE-USE-POLICY.md). \n\n Signing up for an API key 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 7,200 calls an hour (120 calls per minute) to <a href=\"mailto:APIinfo@fec.gov\">APIinfo@fec.gov</a>. You can also ask questions and discuss the data in a community led [group](https://groups.google.com/forum/#!forum/fec-data). \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 [Inspect our source code](https://github.com/fecgov/openFEC). We welcome issues and pull requests! \n\n <p><br></p> <h2 class=\"title\" id=\"signup_head\">Sign up for an API key</h2> <div id=\"apidatagov_signup\">Loading signup form...</div>","title":"OpenFEC","version":"1.0","x-apisguru-categories":["open_data"],"x-logo":{"url":"https://twitter.com/FEC/profile_image?size=original"},"x-origin":[{"format":"openapi","url":"https://api.open.fec.gov/swagger/","version":"3.0"}],"x-providerName":"fec.gov"},"security":[{"ApiKeyHeaderAuth":[],"ApiKeyQueryAuth":[],"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](https://www.fec.gov/resources/cms-content/documents/fecfrm1.pdf) for committee information and [Form 2](https://www.fec.gov/resources/cms-content/documents/fecfrm2.pdf) for candidate 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, Form 13, 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](https://www.fec.gov/pdf/forms/fecfrm5.pdf), for independent expenditors; or the summary and detailed summary pages of the FEC [Form 3](https://www.fec.gov/pdf/forms/fecfrm3.pdf), for House and Senate committees; [Form 3X](https://www.fec.gov/pdf/forms/fecfrm3x.pdf), for PACs and parties; [Form 13](https://www.fec.gov/pdf/forms/fecfrm13.pdf) for inaugural committees; and [Form 3P](https://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":"This collection of endpoints includes Schedule A records reported by a committee. Schedule A records describe itemized receipts, including contributions from individuals. If you are interested in contributions from individuals, use the /schedules/schedule_a/ endpoint. For a more complete description of all Schedule A records visit [About receipts data](https://www.fec.gov/campaign-finance-data/about-campaign-finance-data/about-receipts-data/). If you are interested in our \"is_individual\" methodology visit our [methodology page](https://www.fec.gov/campaign-finance-data/about-campaign-finance-data/methodology/). \n\n \n\n \n\n Schedule A is also available as a database dump file that is updated weekly on Sunday. The database dump files are here: https://www.fec.gov/files/bulk-downloads/index.html?prefix=bulk-downloads/data-dump/schedules/. The instructions are here: https://www.fec.gov/files//bulk-downloads/data-dump/schedules/README.txt. We cannot provide help with restoring the database dump files, but you can refer to this community led [group](https://groups.google.com/forum/#!forum/fec-data) for discussion.","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](https://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":"Data supporting fec.gov's presidential map. \n\n For more information about the presidential map data available to download from fec.gov, please visit: https://www.fec.gov/campaign-finance-data/presidential-map-data/","name":"presidential"},{"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 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.","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":"\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":{"format":"int32","type":"integer"}},{"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.","explode":true,"in":"query","name":"q","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"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":{"default":"all","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","explode":true,"in":"query","name":"cycle","required":false,"schema":{"items":{"format":"int32","type":"integer"},"type":"array"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"\nPrimary/foreign key for audit tables\n","explode":true,"in":"query","name":"audit_case_id","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"default":false,"type":"boolean"}},{"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.\nFirst character indicates office - [P]residential, [H]ouse, [S]enate].\nSecond character is the last digit of the two-year period the ID was created.\nThird and fourth is the candidate state. Presidential IDs don't have state.\nFifth and sixth is the district when the candidate first ran. This does not change if the\ncandidate/member's district changes during re-districting. Presidential IDs don't have districts.\nThe rest is sequence.\n","explode":true,"in":"query","name":"candidate_id","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Name of candidate running for office","explode":true,"in":"query","name":"qq","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"default":20,"format":"int32","type":"integer"}},{"description":"\nProvide a field to sort by. Use `-` for descending order. ex: `-case_no`\n","explode":true,"in":"query","name":"sort","required":false,"schema":{"default":["-cycle","committee_name"],"items":{"type":"string"},"type":"array"},"x-nullable":true},{"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":{"format":"int32","type":"integer"}},{"description":"\nThe audit issue. Each subcategory has an unique ID\n","explode":true,"in":"query","name":"audit_id","required":false,"schema":{"items":{"format":"int32","type":"integer"},"type":"array"}},{"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":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"default":"DEMO_KEY","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 expenditure filer (not a committee)\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","explode":true,"in":"query","name":"committee_type","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"default":1,"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","explode":true,"in":"query","name":"committee_id","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"\nAudit category ID (table PK)\n","in":"query","name":"primary_category_id","required":false,"schema":{"default":"all","type":"string"}}],"responses":{"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditCasePage"}}},"description":""}},"tags":["audit"]}},"/audit-category/":{"get":{"description":"\nThis lists the options for the categories and subcategories available in the /audit-search/ endpoint.\n","parameters":[{"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":{"default":"DEMO_KEY","type":"string"}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"default":1,"format":"int32","type":"integer"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"default":20,"format":"int32","type":"integer"}},{"description":"\nAudit category ID (table PK)\n","explode":true,"in":"query","name":"primary_category_id","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Provide a field to sort by. Use `-` for descending order.\n","in":"query","name":"sort","required":false,"schema":{"default":"primary_category_name","type":"string"}},{"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","explode":true,"in":"query","name":"primary_category_name","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditCategoryPage"}}},"description":""}},"tags":["audit"]}},"/audit-primary-category/":{"get":{"description":"\nThis lists the options for the primary categories available in the /audit-search/ endpoint.\n","parameters":[{"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":{"default":"DEMO_KEY","type":"string"}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"default":1,"format":"int32","type":"integer"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"default":20,"format":"int32","type":"integer"}},{"description":"\nAudit category ID (table PK)\n","explode":true,"in":"query","name":"primary_category_id","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Provide a field to sort by. Use `-` for descending order.\n","in":"query","name":"sort","required":false,"schema":{"default":"primary_category_name","type":"string"}},{"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","explode":true,"in":"query","name":"primary_category_name","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditPrimaryCategoryPage"}}},"description":""}},"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","explode":true,"in":"query","name":"calendar_category_id","required":false,"schema":{"items":{"format":"int32","type":"integer"},"type":"array"}},{"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":{"default":"DEMO_KEY","type":"string"}},{"description":"Brief description of event","explode":true,"in":"query","name":"description","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"default":1,"format":"int32","type":"integer"}},{"description":"\nThe maximum end date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"max_end_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Longer description of event","explode":true,"in":"query","name":"summary","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"\nThe minimum end date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"min_end_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"\nThe minimum start date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"min_start_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"\nThe maximum start date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"max_start_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"default":20,"format":"int32","type":"integer"}},{"description":"Provide a field to sort by. Use `-` for descending order.\n","in":"query","name":"sort","required":false,"schema":{"default":"-start_date","type":"string"}},{"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":{"format":"int32","type":"integer"}}],"responses":{"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarDatePage"}}},"description":""}},"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","explode":true,"in":"query","name":"calendar_category_id","required":false,"schema":{"items":{"format":"int32","type":"integer"},"type":"array"}},{"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":{"default":"DEMO_KEY","type":"string"}},{"description":"Brief description of event","explode":true,"in":"query","name":"description","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"default":1,"format":"int32","type":"integer"}},{"description":"\nThe maximum end date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"max_end_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Longer description of event","explode":true,"in":"query","name":"summary","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"\nThe minimum end date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"min_end_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"\nThe minimum start date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"min_start_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"default":20,"format":"int32","type":"integer"}},{"description":"\nThe maximum start date.(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"max_start_date","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"renderer","required":false,"schema":{"default":"ics","enum":["ics","csv"],"type":"string"}},{"description":"Provide a field to sort by. Use `-` for descending order.\n","in":"query","name":"sort","required":false,"schema":{"default":"-start_date","type":"string"}},{"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":{"format":"int32","type":"integer"}}],"responses":{"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarDatePage"}}},"description":""}},"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","parameters":[{"description":"One-letter code ('I', 'C', 'O') explaining if the candidate is an incumbent, a challenger, or if the seat is open.","explode":true,"in":"query","name":"incumbent_challenge","required":false,"schema":{"items":{"enum":["","I","C","O"],"type":"string"},"type":"array"}},{"description":"\nTwo-year election cycle in which a candidate runs for office.\nCalculated from 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 retrieve 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","explode":true,"in":"query","name":"cycle","required":false,"schema":{"items":{"format":"int32","type":"integer"},"type":"array"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"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":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Name (candidate or committee) to search for. Alias for 'q'.","explode":true,"in":"query","name":"name","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"default":20,"format":"int32","type":"integer"}},{"description":"Year of election","explode":true,"in":"query","name":"election_year","required":false,"schema":{"items":{"format":"int32","type":"integer"},"type":"array"}},{"description":"Federal office candidate runs for: H, S or P","explode":true,"in":"query","name":"office","required":false,"schema":{"items":{"enum":["","H","S","P"],"type":"string"},"type":"array"}},{"description":"Provide a field to sort by. Use `-` for descending order.\n","in":"query","name":"sort","required":false,"schema":{"default":"name","type":"string"}},{"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","explode":true,"in":"query","name":"candidate_status","required":false,"schema":{"items":{"enum":["","C","F","N","P"],"type":"string"},"type":"array"}},{"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.","explode":true,"in":"query","name":"district","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"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":{"default":"DEMO_KEY","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":"Three-letter code for the party affiliated with a candidate or committee. For example, DEM for Democratic Party and REP for Republican Party.","explode":true,"in":"query","name":"party","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"default":1,"format":"int32","type":"integer"}},{"description":"US state or territory where a candidate runs for office","explode":true,"in":"query","name":"state","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Retrieve 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":"\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.\nFirst character indicates office - [P]residential, [H]ouse, [S]enate].\nSecond character is the last digit of the two-year period the ID was created.\nThird and fourth is the candidate state. Presidential IDs don't have state.\nFifth and sixth is the district when the candidate first ran. This does not change if the\ncandidate/member's district changes during re-districting. Presidential IDs don't have districts.\nThe rest is sequence.\n","in":"path","name":"candidate_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateDetailPage"}}},"description":""}},"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":"\nAPI key for https://api.data.gov. Get one at https://api.data.gov/signup.\n","in":"query","name":"api_key","required":true,"schema":{"default":"DEMO_KEY","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 expenditure filer (not a committee)\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","explode":true,"in":"query","name":"committee_type","required":false,"schema":{"items":{"enum":["","C","D","E","H","I","N","O","P","Q","S","U","V","W","X","Y","Z"],"type":"string"},"type":"array"}},{"description":"\nA two year election cycle that the committee was active- (after original registration\ndate but before expiration date in Form 1s) The cycle begins with\nan odd year and is named for its ending, even year.\n","explode":true,"in":"query","name":"cycle","required":false,"schema":{"items":{"format":"int32","type":"integer"},"type":"array"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"default":1,"format":"int32","type":"integer"}},{"description":"A year that the committee was active— (after original registration date or filing but before expiration date)","explode":true,"in":"query","name":"year","required":false,"schema":{"items":{"format":"int32","type":"integer"},"type":"array"}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"default":20,"format":"int32","type":"integer"}},{"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","explode":true,"in":"query","name":"filing_frequency","required":false,"schema":{"items":{"enum":["","A","M","N","Q","T","W","-A","-T"],"type":"string"},"type":"array"}},{"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","explode":true,"in":"query","name":"organization_type","required":false,"schema":{"items":{"enum":["","C","L","M","T","V","W"],"type":"string"},"type":"array"}},{"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","explode":true,"in":"query","name":"designation","required":false,"schema":{"items":{"enum":["","A","J","P","U","B","D"],"type":"string"},"type":"array"}},{"description":"Provide a field to sort by. Use `-` for descending order.\n","in":"query","name":"sort","required":false,"schema":{"default":"name","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.\nFirst character indicates office - [P]residential, [H]ouse, [S]enate].\nSecond character is the last digit of the two-year period the ID was created.\nThird and fourth is the candidate state. Presidential IDs don't have state.\nFifth and sixth is the district when the candidate first ran. This does not change if the\ncandidate/member's district changes during re-districting. Presidential IDs don't have districts.\nThe rest is sequence.\n","in":"path","name":"candidate_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitteeDetailPage"}}},"description":""}},"tags":["committee"]}},"/candidate/{candidate_id}/committees/history/":{"get":{"description":"\nExplore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or `committee_type`.\n","parameters":[{"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":{"default":"DEMO_KEY","type":"string"}},{"description":"`True` indicates that full election period of a candidate.\n`False` indicates that two year election cycle.","in":"query","name":"election_full","required":false,"schema":{"default":true,"type":"boolean"}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"default":1,"format":"int32","type":"integer"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"default":20,"format":"int32","type":"integer"}},{"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","explode":true,"in":"query","name":"designation","required":false,"schema":{"items":{"enum":["","A","J","P","U","B","D"],"type":"string"},"type":"array"}},{"description":"Provide a field to sort by. Use `-` for descending order.\n","in":"query","name":"sort","required":false,"schema":{"default":"-cycle","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.\nFirst character indicates office - [P]residential, [H]ouse, [S]enate].\nSecond character is the last digit of the two-year period the ID was created.\nThird and fourth is the candidate state. Presidential IDs don't have state.\nFifth and sixth is the district when the candidate first ran. This does not change if the\ncandidate/member's district changes during re-districting. Presidential IDs don't have districts.\nThe rest is sequence.\n","in":"path","name":"candidate_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitteeHistoryProfilePage"}}},"description":""}},"tags":["committee"]}},"/candidate/{candidate_id}/committees/history/{cycle}/":{"get":{"description":"\nExplore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or `committee_type`.\n","parameters":[{"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":{"default":"DEMO_KEY","type":"string"}},{"description":"`True` indicates that full election period of a candidate.\n`False` indicates that two year election cycle.","in":"query","name":"election_full","required":false,"schema":{"default":true,"type":"boolean"}},{"description":"Toggle that sorts null values last","in":"query","name":"sort_nulls_last","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"For paginating through results, starting at page 1","in":"query","name":"page","required":false,"schema":{"default":1,"format":"int32","type":"integer"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Hide null values on sorted column(s).","in":"query","name":"sort_hide_null","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"The number of results returned per page. Defaults to 20.","in":"query","name":"per_page","required":false,"schema":{"default":20,"format":"int32","type":"integer"}},{"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","explode":true,"in":"query","name":"designation","required":false,"schema":{"items":{"enum":["","A","J","P","U","B","D"],"type":"string"},"type":"array"}},{"description":"Provide a field to sort by. Use `-` for descending order.\n","in":"query","name":"sort","required":false,"schema":{"default":"-cycle","type":"string"}},{"description":"\nA two year election cycle that the committee was active- (after original registration\ndate but before expiration date in 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":{"format":"int32","type":"integer"}},{"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.\nFirst character indicates office - [P]residential, [H]ouse, [S]enate].\nSecond character is the last digit of the two-year period the ID was created.\nThird and fourth is the candidate state. Presidential IDs don't have state.\nFifth and sixth is the district when the candidate first ran. This does not change if the\ncandidate/member's district changes during re-districting. Presidential IDs don't have districts.\nThe rest is sequence.\n","in":"path","name":"candidate_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitteeHistoryProfilePage"}}},"description":""}},"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":"\nFalse indicates that a report is the most recent. True indicates that the report has been superseded by an amendment.\n","in":"query","name":"is_amended","required":false,"schema":{"type":"boolean"}},{"description":"\nSelects all filings received after this date(MM/DD/YYYY or YYYY-MM-DD)\n","in":"query","name":"min_receipt_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"\nThe forms filed are categorized based on the nature of the filing:\n - REPORT F3, F3X, F3P, F3L, F4, F5, F7, F13\n - NOTICE F5, F24, F6, F9, F10, F11\n - STATEMENT F1, F2\n - OTHER F1M, F8, F99, F12, FRQ\n","explode":true,"in":"query","name":"form_category","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"\nRequests for additional information (RFAIs) sent to filers. The request type is based on the type of document filed:\n - 1 Statement of Organization\n - 2 Report of Receipts and Expenditures (Form 3 and 3X)\n - 3 Second Notice - Reports\n - 4 Request for Additional Information\n - 5 Informational - Reports\n - 6 Second Notice - Statement of Organization\n - 7 Failure to File\n - 8 From Public Disclosure\n - 9 From Multi Candidate Status\n","explode":true,"in":"query","name":"request_type","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"\nPrimary, general or special election indicator.\n","explode":true,"in":"query","name":"primary_general_indicator","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"\nFilter records to only those that were applicable to a given\ntwo-year period.The cycle begins with an odd year and is named\nfor its ending, even year.\n","explode":true,"in":"query","name":"cycle","required":false,"schema":{"items":{"format":"int32","type":"integer"},"type":"array"}},{"description":"Toggle that filters out all rows having sort column that is non-null","in":"query","name":"sort_null_only","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"\nSelects all filings received before