{"openapi":"3.1.0","info":{"title":"Poliscope REST API","version":"1.0.0","description":"U.S. political data API — campaign finance, congressional legislation, lobbying disclosures, government contracts, and SEC filings. Requires an API key (x-api-key header). Free tier: 100 requests/minute. Get your key at poliscope.org/developers.","contact":{"name":"Poliscope","url":"https://www.poliscope.org"}},"servers":[{"url":"https://api.poliscope.org","description":"Production"}],"tags":[{"name":"Politicians","description":"Candidates, legislators, committees, and elections"},{"name":"Campaign Finance","description":"Donors, stock trades, political spending, and raw FEC filings (disbursements, IEs, loans, debts)"},{"name":"Bills & Legislation","description":"Congressional bills, votes, and sponsors"},{"name":"Lobbying","description":"Lobbying clients, firms, and issue areas"},{"name":"Government Contracts","description":"Federal contract awards, recipients, and agencies"},{"name":"Corporate","description":"Company profiles with cross-source financial data"},{"name":"Pensions","description":"Public pension plans — financials, allocations, funded ratios"},{"name":"Nonprofits & Dark Money","description":"Tax-exempt organizations, 990 filings, grant flows"},{"name":"Search","description":"Universal cross-source search"},{"name":"Platform","description":"Platform-level metadata and data coverage counts"}],"components":{"schemas":{"V1StatsData":{"type":"object","properties":{"contributions":{"type":"object","properties":{"individual_records":{"type":"number"},"total_raised":{"type":"number"},"total_disbursed":{"type":"number"}},"required":["individual_records","total_raised","total_disbursed"]},"lobbying":{"type":"object","properties":{"filing_count":{"type":"number"}},"required":["filing_count"]},"contracts":{"type":"object","properties":{"total_awards":{"type":"number"}},"required":["total_awards"]},"entities":{"type":"object","properties":{"total":{"type":"number"},"edges":{"type":"number"}},"required":["total","edges"]},"congress":{"type":"object","properties":{"candidates":{"type":"number"},"committees":{"type":"number"},"legislators":{"type":"number"},"bills":{"type":"number"},"votes":{"type":"number"}},"required":["candidates","committees","legislators","bills","votes"]},"sec":{"type":"object","properties":{"filings":{"type":"number"}},"required":["filings"]}},"required":["contributions","lobbying","contracts","entities","congress","sec"]},"V1Meta":{"type":"object","properties":{"limit":{"type":"number","description":"Requested limit"},"offset":{"type":"number","description":"Requested offset"},"sort_by":{"type":"string","description":"Field used to sort results (e.g. \"total_raised\")"},"sort_dir":{"type":"string","description":"\"asc\" or \"desc\""},"source":{"type":"string","description":"Data source attribution"}},"required":["source"]},"V1StatsResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1StatsData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}},"required":["error"]},"V1SearchData":{"type":"object","properties":{"politicians":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"party":{"type":["string","null"]},"office":{"type":["string","null"]},"state":{"type":["string","null"]},"cycle":{"type":["number","null"]},"result_type":{"type":"string"}},"required":["id","name","party","office","state","cycle","result_type"]}},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["string","null"]},"state":{"type":["string","null"]},"ticker":{"type":["string","null"]},"influence_score":{"type":["number","null"]},"result_type":{"type":"string"}},"required":["id","name","type","state","ticker","influence_score","result_type"]}},"legislators":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"chamber":{"type":["string","null"]},"result_type":{"type":"string"}},"required":["id","name","party","state","chamber","result_type"]}},"lobbying_clients":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":["string","null"]},"total_spent":{"type":["number","null"]},"result_type":{"type":"string"}},"required":["name","entity_id","total_spent","result_type"]}},"donors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["string","null"]},"state":{"type":["string","null"]},"total_contributed":{"type":["number","null"]},"influence_score":{"type":["number","null"]},"result_type":{"type":"string"}},"required":["id","name","type","state","total_contributed","influence_score","result_type"]},"description":"Donor entities (individual + organization) from mv_donor_rankings, ranked by contribution volume"},"bills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":["string","null"]},"congress":{"type":["number","null"]},"title":{"type":["string","null"]},"policy_area":{"type":["string","null"]},"result_type":{"type":"string"}},"required":["id","number","congress","title","policy_area","result_type"]}},"appointees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"agency":{"type":["string","null"]},"position_title":{"type":["string","null"]},"administration":{"type":["string","null"]},"result_type":{"type":"string"}},"required":["id","name","agency","position_title","administration","result_type"]},"description":"Executive branch financial disclosure filers from dim_appointee"},"gift_travel":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"chamber":{"type":["string","null"]},"office":{"type":["string","null"]},"filing_type":{"type":["string","null"]},"reporting_year":{"type":["number","null"]},"travel_sponsor":{"type":["string","null"]},"travel_destination":{"type":["string","null"]},"gift_source":{"type":["string","null"]},"result_type":{"type":"string"}},"required":["id","name","chamber","office","filing_type","reporting_year","travel_sponsor","travel_destination","gift_source","result_type"]},"description":"Congressional gift and travel disclosures from House Clerk + Senate Gift Rule filings"}}},"V1SearchResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1SearchData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1PoliticianRow":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"party":{"type":["string","null"]},"office":{"type":["string","null"]},"state":{"type":["string","null"]},"district":{"type":["string","null"]},"cycle":{"type":["number","null"]},"entity_id":{"type":["string","null"]},"bioguide_id":{"type":["string","null"],"description":"Congress.gov bioguide ID for cross-linking to legislator endpoints (only present for candidates who became members of Congress)"},"is_current_member":{"type":["boolean","null"],"description":"Whether this candidate is a current serving member of Congress"},"chamber":{"type":["string","null"],"description":"Chamber (\"house\" / \"senate\") if this candidate is a member of Congress"},"photo_url":{"type":["string","null"],"description":"Official portrait URL (when candidate is a legislator)"},"total_raised":{"type":"number"},"num_contributions":{"type":"number"},"num_donors":{"type":"number"},"small_dollar_pct":{"type":["number","null"]}},"required":["id","name","party","office","state","district","cycle","entity_id","bioguide_id","is_current_member","chamber","photo_url","total_raised","num_contributions","num_donors","small_dollar_pct"]},"V1PoliticianListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1PoliticianRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1PoliticianCampaign":{"type":"object","properties":{"cand_id":{"type":"string"},"office":{"type":["string","null"]},"state":{"type":["string","null"]},"district":{"type":["string","null"]},"cycle":{"type":"number"},"total_raised":{"type":["number","null"]}},"required":["cand_id","office","state","district","cycle","total_raised"]},"V1PoliticianCommittee":{"type":"object","properties":{"committee_id":{"type":"string"},"name":{"type":["string","null"]},"type":{"type":["string","null"]},"designation":{"type":["string","null"]},"entity_id":{"type":["string","null"]},"total_raised":{"type":"number"}},"required":["committee_id","name","type","designation","entity_id","total_raised"]},"V1CycleFundraising":{"type":"object","properties":{"cycle":{"type":"number"},"total_raised":{"type":"number"},"num_contributions":{"type":"number"},"num_donors":{"type":"number"}},"required":["cycle","total_raised","num_contributions","num_donors"]},"V1PoliticianContributor":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":["string","null"]},"state":{"type":["string","null"]},"type":{"type":"string"},"total":{"type":"number"},"from_individuals":{"type":["number","null"]},"from_pacs":{"type":["number","null"]},"num_contributions":{"type":"number"}},"required":["name","entity_id","state","type","total","from_individuals","from_pacs","num_contributions"]},"V1PoliticianIndustry":{"type":"object","properties":{"industry":{"type":"string"},"total":{"type":"number"},"num_contributions":{"type":"number"},"num_donors":{"type":"number"}},"required":["industry","total","num_contributions","num_donors"]},"V1PoliticianDetail":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"party":{"type":["string","null"]},"office":{"type":["string","null"]},"state":{"type":["string","null"]},"district":{"type":["string","null"]},"cycle":{"type":["number","null"]},"entity_id":{"type":["string","null"]},"bioguide_id":{"type":["string","null"]},"is_current_member":{"type":"boolean"},"total_raised":{"type":"number"},"num_contributions":{"type":"number"},"num_donors":{"type":["number","null"]},"avg_contribution":{"type":["number","null"]},"small_dollar_pct":{"type":["number","null"]},"large_donor_pct":{"type":["number","null"]},"in_state_pct":{"type":["number","null"]},"out_state_pct":{"type":["number","null"]},"available_cycles":{"type":"array","items":{"type":"number"}},"all_campaigns":{"type":"array","items":{"$ref":"#/components/schemas/V1PoliticianCampaign"}},"committees":{"type":"array","items":{"$ref":"#/components/schemas/V1PoliticianCommittee"}},"by_cycle":{"type":"array","items":{"$ref":"#/components/schemas/V1CycleFundraising"}},"top_contributors":{"type":"array","items":{"$ref":"#/components/schemas/V1PoliticianContributor"}},"top_industries":{"type":"array","items":{"$ref":"#/components/schemas/V1PoliticianIndustry"}},"narrative":{"type":["string","null"],"description":"Auto-generated narrative summary of the politician"},"website":{"type":["string","null"],"description":"Official website (from legislator profile, when available)"},"phone":{"type":["string","null"],"description":"Official office phone number"},"office_address":{"type":["string","null"],"description":"Official office address"},"contact_form":{"type":["string","null"],"description":"URL of the official contact form"},"birthday":{"type":["string","null"],"description":"Birthday (when available from legislator profile)"},"gender":{"type":["string","null"],"description":"Gender (M/F, when available from legislator profile)"},"photo_url":{"type":["string","null"],"description":"Official portrait URL (when candidate is a legislator)"}},"required":["id","name","party","office","state","district","cycle","entity_id","bioguide_id","is_current_member","total_raised","num_contributions","num_donors","avg_contribution","small_dollar_pct","large_donor_pct","in_state_pct","out_state_pct","available_cycles","all_campaigns","committees","by_cycle","top_contributors","top_industries"]},"V1PoliticianDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1PoliticianDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LegislatorRow":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"chamber":{"type":["string","null"]},"district":{"type":["string","null"]},"is_current":{"type":"boolean"},"total_raised":{"type":"number"},"influence_score":{"type":["number","null"]},"photo_url":{"type":["string","null"],"description":"Official portrait URL"}},"required":["id","name","party","state","chamber","district","is_current","total_raised","influence_score"]},"V1LegislatorListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1LegislatorRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LegislatorDonor":{"type":"object","properties":{"name":{"type":"string"},"state":{"type":["string","null"]},"total":{"type":"number"},"num_contributions":{"type":"number"},"rank":{"type":"number"}},"required":["name","state","total","num_contributions","rank"]},"V1LegislatorIndustry":{"type":"object","properties":{"industry":{"type":"string"},"total":{"type":"number"},"num_contributions":{"type":"number"},"rank":{"type":"number"}},"required":["industry","total","num_contributions","rank"]},"V1LegislatorBill":{"type":"object","properties":{"bill_id":{"type":"string"},"number":{"type":["string","null"]},"congress":{"type":["number","null"]},"title":{"type":["string","null"]},"policy_area":{"type":["string","null"]},"latest_action_date":{"type":["string","null"]},"became_law":{"type":["boolean","null"]},"sponsor_type":{"type":"string"}},"required":["bill_id","number","congress","title","policy_area","latest_action_date","became_law","sponsor_type"]},"V1VotingSummary":{"type":["object","null"],"properties":{"total_votes":{"type":"number"},"yea_count":{"type":"number"},"nay_count":{"type":"number"},"present_count":{"type":"number"},"not_voting_count":{"type":"number"}},"required":["total_votes","yea_count","nay_count","present_count","not_voting_count"]},"V1LegislatorDetail":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"chamber":{"type":["string","null"]},"district":{"type":["string","null"]},"is_current":{"type":"boolean"},"entity_id":{"type":["string","null"]},"fec_candidate_id":{"type":["string","null"]},"candidate_entity_id":{"type":["string","null"],"description":"Entity UUID for the associated FEC candidate record (may differ from the legislator entity_id; use for cross-linking to get_politician)"},"website":{"type":["string","null"]},"phone":{"type":["string","null"]},"office_address":{"type":["string","null"]},"contact_form":{"type":["string","null"]},"birthday":{"type":["string","null"]},"gender":{"type":["string","null"]},"photo_url":{"type":["string","null"]},"terms":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Congressional term history (JSONB)"},"total_raised":{"type":["number","null"]},"num_contributions":{"type":["number","null"]},"num_donors":{"type":["number","null"]},"avg_contribution":{"type":["number","null"]},"small_dollar_pct":{"type":["number","null"]},"large_donor_pct":{"type":["number","null"]},"in_state_pct":{"type":["number","null"]},"out_state_pct":{"type":["number","null"]},"influence_score":{"type":["number","null"]},"top_donors":{"type":"array","items":{"$ref":"#/components/schemas/V1LegislatorDonor"}},"top_industries":{"type":"array","items":{"$ref":"#/components/schemas/V1LegislatorIndustry"}},"by_cycle":{"type":"array","items":{"$ref":"#/components/schemas/V1CycleFundraising"}},"recent_bills":{"type":"array","items":{"$ref":"#/components/schemas/V1LegislatorBill"}},"voting_summary":{"$ref":"#/components/schemas/V1VotingSummary"}},"required":["id","name","party","state","chamber","district","is_current","entity_id","fec_candidate_id","website","phone","office_address","contact_form","birthday","gender","photo_url","terms","total_raised","num_contributions","num_donors","avg_contribution","small_dollar_pct","large_donor_pct","in_state_pct","out_state_pct","influence_score","top_donors","top_industries","by_cycle","recent_bills","voting_summary"]},"V1LegislatorDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1LegislatorDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LegislatorVoteRow":{"type":"object","properties":{"vote_id":{"type":"number"},"vote_date":{"type":["string","null"]},"bill_id":{"type":["string","null"]},"chamber":{"type":["string","null"]},"congress":{"type":["number","null"]},"roll_call_number":{"type":["number","null"]},"vote_question":{"type":["string","null"]},"vote_result":{"type":["string","null"]},"yes_total":{"type":["number","null"]},"no_total":{"type":["number","null"]},"vote_position":{"type":"string"},"bill_number":{"type":["string","null"]},"bill_title":{"type":["string","null"]}},"required":["vote_id","vote_date","bill_id","chamber","congress","roll_call_number","vote_question","vote_result","yes_total","no_total","vote_position","bill_number","bill_title"]},"V1LegislatorVotesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1LegislatorVoteRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DonorRow":{"type":"object","properties":{"entity_id":{"type":["string","null"]},"name":{"type":"string"},"type":{"type":["string","null"]},"state":{"type":["string","null"]},"total_contributed":{"type":"number"},"influence_score":{"type":["number","null"]}},"required":["entity_id","name","type","state","total_contributed","influence_score"]},"V1DonorListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1DonorRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1CommitteeRow":{"type":"object","properties":{"committee_id":{"type":"string"},"name":{"type":"string"},"type":{"type":["string","null"]},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"entity_id":{"type":["string","null"]},"total_raised":{"type":"number"},"num_donors":{"type":["number","null"]}},"required":["committee_id","name","type","party","state","entity_id","total_raised","num_donors"]},"V1CommitteeListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1CommitteeRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1CommitteeDonor":{"type":"object","properties":{"name":{"type":"string"},"state":{"type":["string","null"]},"is_individual":{"type":"boolean"},"total":{"type":"number"},"num_contributions":{"type":"number"},"rank":{"type":"number"}},"required":["name","state","is_individual","total","num_contributions","rank"]},"V1CommitteeRecipient":{"type":"object","properties":{"name":{"type":["string","null"]},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"cycle":{"type":["number","null"]},"total":{"type":"number"},"num_contributions":{"type":"number"}},"required":["name","party","state","cycle","total","num_contributions"]},"V1CommitteePartySplit":{"type":"object","properties":{"cycle":{"type":"number"},"to_democrats":{"type":["number","null"]},"to_republicans":{"type":["number","null"]},"total":{"type":["number","null"]}},"required":["cycle","to_democrats","to_republicans","total"]},"V1CommitteeDetail":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["string","null"]},"designation":{"type":["string","null"]},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"entity_id":{"type":["string","null"]},"candidate_id":{"type":["string","null"],"description":"Linked FEC candidate ID (for candidate committees)"},"candidate_name":{"type":["string","null"],"description":"Linked candidate name (joined from dim_candidate)"},"candidate_entity_id":{"type":["string","null"],"description":"Entity UUID for the linked candidate (cross-link to get_politician)"},"candidate_bioguide_id":{"type":["string","null"],"description":"Bioguide ID for the linked candidate (cross-link to get_legislator)"},"connected_org":{"type":["string","null"],"description":"Connected organization name (e.g. parent union or trade association)"},"connected_org_entity_id":{"type":["string","null"],"description":"Entity UUID for the connected organization (cross-link to get_company)"},"narrative":{"type":["string","null"],"description":"Auto-generated narrative summary of the committee"},"total_raised":{"type":"number"},"total_spent":{"type":"number"},"num_contributions":{"type":["number","null"]},"num_donors":{"type":["number","null"]},"top_donors":{"type":"array","items":{"$ref":"#/components/schemas/V1CommitteeDonor"}},"by_cycle":{"type":"array","items":{"$ref":"#/components/schemas/V1CycleFundraising"}},"recipients":{"type":"array","items":{"$ref":"#/components/schemas/V1CommitteeRecipient"}},"party_split_by_cycle":{"type":"array","items":{"$ref":"#/components/schemas/V1CommitteePartySplit"}}},"required":["id","name","type","designation","party","state","entity_id","total_raised","total_spent","num_contributions","num_donors","top_donors","by_cycle","recipients","party_split_by_cycle"]},"V1CommitteeDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1CommitteeDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LobbyingClientRow":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":["string","null"]},"total_spent":{"type":["number","null"]},"total_income":{"type":["number","null"]},"num_filings":{"type":"number"},"last_year":{"type":["number","null"]}},"required":["name","entity_id","total_spent","total_income","num_filings","last_year"]},"V1LobbyingClientListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1LobbyingClientRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LobbyingFirmRow":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":["string","null"]},"revenue":{"type":["number","null"]},"num_filings":{"type":"number"},"last_year":{"type":["number","null"]}},"required":["name","entity_id","revenue","num_filings","last_year"]},"V1LobbyingFirmListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1LobbyingFirmRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1BillRow":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":["string","null"]},"congress":{"type":["number","null"]},"type":{"type":["string","null"]},"title":{"type":["string","null"]},"policy_area":{"type":["string","null"]},"latest_action_date":{"type":["string","null"]},"became_law":{"type":["boolean","null"]},"status":{"type":["string","null"]},"primary_sponsor":{"type":["string","null"]}},"required":["id","number","congress","type","title","policy_area","latest_action_date","became_law","status","primary_sponsor"]},"V1BillListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1BillRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1BillSponsor":{"type":"object","properties":{"bioguide_id":{"type":["string","null"]},"fec_candidate_id":{"type":["string","null"],"description":"FEC candidate ID for cross-linking to politician profile"},"sponsor_type":{"type":["string","null"]},"name":{"type":["string","null"]},"party":{"type":["string","null"]},"state":{"type":["string","null"]}},"required":["bioguide_id","fec_candidate_id","sponsor_type","name","party","state"]},"V1BillAction":{"type":"object","properties":{"action_date":{"type":["string","null"]},"action_text":{"type":["string","null"]},"action_type":{"type":["string","null"]},"chamber":{"type":["string","null"]}},"required":["action_date","action_text","action_type","chamber"]},"V1BillTextVersion":{"type":"object","properties":{"version_type":{"type":["string","null"]},"version_date":{"type":["string","null"]},"format_url_txt":{"type":["string","null"]},"format_url_pdf":{"type":["string","null"]},"format_url_xml":{"type":["string","null"]},"has_full_text":{"type":"boolean"}},"required":["version_type","version_date","format_url_txt","format_url_pdf","format_url_xml","has_full_text"]},"V1BillCommittee":{"type":"object","properties":{"committee_name":{"type":["string","null"]},"committee_code":{"type":["string","null"]},"chamber":{"type":["string","null"]},"activity_type":{"type":["string","null"]},"activity_date":{"type":["string","null"]}},"required":["committee_name","committee_code","chamber","activity_type","activity_date"]},"V1BillRelated":{"type":"object","properties":{"related_bill_id":{"type":["string","null"]},"related_congress":{"type":["number","null"]},"related_type":{"type":["string","null"]},"related_number":{"type":["string","null"]},"relationship_type":{"type":["string","null"]}},"required":["related_bill_id","related_congress","related_type","related_number","relationship_type"]},"V1SimilarBill":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":["string","null"]},"congress":{"type":["number","null"]},"title":{"type":["string","null"]},"similarity":{"type":"number"}},"required":["id","number","congress","title","similarity"]},"V1BillVoteSummary":{"type":["object","null"],"properties":{"total_votes":{"type":["number","null"]},"yes_count":{"type":["number","null"]},"no_count":{"type":["number","null"]},"present_count":{"type":["number","null"]},"not_voting_count":{"type":["number","null"]},"dem_yes":{"type":["number","null"]},"dem_no":{"type":["number","null"]},"rep_yes":{"type":["number","null"]},"rep_no":{"type":["number","null"]},"ind_yes":{"type":["number","null"]},"ind_no":{"type":["number","null"]},"bipartisan_score":{"type":["number","null"]}},"required":["total_votes","yes_count","no_count","present_count","not_voting_count","dem_yes","dem_no","rep_yes","rep_no","ind_yes","ind_no","bipartisan_score"]},"V1BillRollCall":{"type":"object","properties":{"vote_id":{"type":"number"},"chamber":{"type":["string","null"]},"congress":{"type":["number","null"]},"session":{"type":["number","null"]},"roll_call_number":{"type":["number","null"]},"vote_date":{"type":["string","null"]},"vote_question":{"type":["string","null"]},"vote_result":{"type":["string","null"]},"yes_total":{"type":["number","null"]},"no_total":{"type":["number","null"]},"present_total":{"type":["number","null"]},"not_voting_total":{"type":["number","null"]}},"required":["vote_id","chamber","congress","session","roll_call_number","vote_date","vote_question","vote_result","yes_total","no_total","present_total","not_voting_total"]},"V1BillDetail":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":["string","null"]},"congress":{"type":["number","null"]},"type":{"type":["string","null"]},"title":{"type":["string","null"]},"short_title":{"type":["string","null"]},"policy_area":{"type":["string","null"]},"introduced_date":{"type":["string","null"]},"latest_action_date":{"type":["string","null"]},"latest_action_text":{"type":["string","null"]},"became_law":{"type":["boolean","null"]},"status":{"type":["string","null"]},"summary":{"type":["string","null"],"description":"CRS summary"},"constitutional_authority":{"type":["string","null"]},"cbo_cost_estimates":{},"primary_sponsor":{"type":["string","null"]},"primary_sponsor_party":{"type":["string","null"]},"primary_sponsor_state":{"type":["string","null"]},"sponsors":{"type":"array","items":{"$ref":"#/components/schemas/V1BillSponsor"}},"actions":{"type":"array","items":{"$ref":"#/components/schemas/V1BillAction"}},"text_versions":{"type":"array","items":{"$ref":"#/components/schemas/V1BillTextVersion"}},"committees":{"type":"array","items":{"$ref":"#/components/schemas/V1BillCommittee"}},"related_bills":{"type":"array","items":{"$ref":"#/components/schemas/V1BillRelated"}},"subjects":{"type":"array","items":{"type":"string"}},"similar_bills":{"type":"array","items":{"$ref":"#/components/schemas/V1SimilarBill"}},"votes":{"type":"object","properties":{"summary":{"$ref":"#/components/schemas/V1BillVoteSummary"},"roll_calls":{"type":"array","items":{"$ref":"#/components/schemas/V1BillRollCall"}}},"required":["summary","roll_calls"]}},"required":["id","number","congress","type","title","short_title","policy_area","introduced_date","latest_action_date","latest_action_text","became_law","status","summary","constitutional_authority","primary_sponsor","primary_sponsor_party","primary_sponsor_state","sponsors","actions","text_versions","committees","related_bills","subjects","similar_bills","votes"]},"V1BillDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1BillDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1BillVotePosition":{"type":"object","properties":{"bioguide_id":{"type":["string","null"]},"vote_position":{"type":"string"},"name":{"type":["string","null"]},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"member_chamber":{"type":["string","null"]}},"required":["bioguide_id","vote_position","name","party","state","member_chamber"]},"V1BillVoteRollCallDetail":{"allOf":[{"$ref":"#/components/schemas/V1BillRollCall"},{"type":"object","properties":{"positions":{"type":"array","items":{"$ref":"#/components/schemas/V1BillVotePosition"}}},"required":["positions"]}]},"V1BillVotesData":{"type":"object","properties":{"summary":{"$ref":"#/components/schemas/V1BillVoteSummary"},"roll_calls":{"type":"array","items":{"$ref":"#/components/schemas/V1BillVoteRollCallDetail"}}},"required":["summary","roll_calls"]},"V1BillVotesResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1BillVotesData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1ContractRecipientRow":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":"string"},"state":{"type":["string","null"]},"total_awarded":{"type":"number"},"num_awards":{"type":"number"},"influence_score":{"type":["number","null"]}},"required":["name","entity_id","state","total_awarded","num_awards","influence_score"]},"V1ContractRecipientListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ContractRecipientRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1ContractAgencyRow":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":["string","null"],"description":"Entity UUID for the agency (if resolved)"},"total_awarded":{"type":"number"},"num_awards":{"type":"number"}},"required":["name","entity_id","total_awarded","num_awards"]},"V1ContractAgencyListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ContractAgencyRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1CompanyRow":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["string","null"]},"state":{"type":["string","null"]},"ticker":{"type":["string","null"]},"sic_code":{"type":["string","null"]},"lei":{"type":["string","null"]},"total_contributed":{"type":"number"},"total_received":{"type":"number"},"total_lobbying":{"type":"number"},"total_contracts":{"type":"number"},"influence_score":{"type":["number","null"]},"has_sec":{"type":"number","description":"1 if the company has linked SEC filings, 0 otherwise"},"has_lda":{"type":"number","description":"1 if the company has linked LDA lobbying filings, 0 otherwise"},"has_activity":{"type":"number","description":"1 if the company has any political activity (contributions, lobbying, contracts, or SEC)"}},"required":["id","name","type","state","ticker","sic_code","lei","total_contributed","total_received","total_lobbying","total_contracts","influence_score"]},"V1CompanyListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1CompanyRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1CompanyRecipient":{"type":"object","properties":{"recipient_name":{"type":"string"},"recipient_entity_id":{"type":"string"},"total":{"type":"number"},"num_contributions":{"type":"number"}},"required":["recipient_name","recipient_entity_id","total","num_contributions"]},"V1CompanyLobbyingYear":{"type":"object","properties":{"year":{"type":"number"},"total_spent":{"type":["number","null"]},"total_income":{"type":["number","null"]},"num_filings":{"type":"number"},"num_firms":{"type":"number"}},"required":["year","total_spent","total_income","num_filings","num_firms"]},"V1CompanyLobbyingIssue":{"type":"object","properties":{"issue_code":{"type":"string"},"num_reports":{"type":"number"}},"required":["issue_code","num_reports"]},"V1CompanyContractAgency":{"type":"object","properties":{"agency_name":{"type":"string"},"agency_entity_id":{"type":["string","null"],"description":"Entity UUID for the agency (if resolved)"},"total_awarded":{"type":"number"},"num_awards":{"type":"number"}},"required":["agency_name","agency_entity_id","total_awarded","num_awards"]},"V1CompanyInsiderSummary":{"type":["object","null"],"properties":{"transaction_count":{"type":"number"},"total_value":{"type":"number"},"total_purchases":{"type":"number"},"total_sales":{"type":"number"},"unique_insiders":{"type":"number"},"earliest_transaction":{"type":["string","null"]},"latest_transaction":{"type":["string","null"]}},"required":["transaction_count","total_value","total_purchases","total_sales","unique_insiders","earliest_transaction","latest_transaction"]},"V1CompanyInsiderTx":{"type":"object","properties":{"transaction_date":{"type":["string","null"]},"transaction_type":{"type":["string","null"]},"owner_name":{"type":["string","null"]},"officer_title":{"type":["string","null"]},"security_title":{"type":["string","null"]},"shares_amount":{"type":["number","null"]},"share_price":{"type":["number","null"]},"total_value":{"type":["number","null"]},"is_director":{"type":["boolean","null"]},"is_officer":{"type":["boolean","null"]},"insider_entity_id":{"type":["string","null"],"description":"Entity UUID for the insider (if resolved)"}},"required":["transaction_date","transaction_type","owner_name","officer_title","security_title","shares_amount","share_price","total_value","is_director","is_officer","insider_entity_id"]},"V1CompanySourceId":{"type":"object","properties":{"source":{"type":"string"},"source_id":{"type":"string"}},"required":["source","source_id"]},"V1CompanyDetail":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["string","null"]},"state":{"type":["string","null"]},"ticker":{"type":["string","null"]},"sic_code":{"type":["string","null"]},"lei":{"type":["string","null"]},"uei":{"type":["string","null"]},"total_contributed":{"type":["number","null"]},"num_contributions":{"type":["number","null"]},"num_recipients":{"type":["number","null"]},"total_received":{"type":["number","null"]},"contribution_in_count":{"type":["number","null"]},"unique_donors":{"type":["number","null"]},"total_lobbying_income":{"type":["number","null"]},"total_lobbying_expense":{"type":["number","null"]},"num_lobbying_filings":{"type":["number","null"]},"total_contracts":{"type":["number","null"]},"num_contracts":{"type":["number","null"]},"influence_score":{"type":["number","null"]},"network_connectivity":{"type":["number","null"]},"first_activity_date":{"type":["string","null"]},"last_activity_date":{"type":["string","null"]},"top_recipients":{"type":"array","items":{"$ref":"#/components/schemas/V1CompanyRecipient"}},"lobbying":{"type":"object","properties":{"by_year":{"type":"array","items":{"$ref":"#/components/schemas/V1CompanyLobbyingYear"}},"top_issues":{"type":"array","items":{"$ref":"#/components/schemas/V1CompanyLobbyingIssue"}}},"required":["by_year","top_issues"]},"contracts":{"type":"object","properties":{"by_agency":{"type":"array","items":{"$ref":"#/components/schemas/V1CompanyContractAgency"}}},"required":["by_agency"]},"sec":{"type":"object","properties":{"insider_summary":{"$ref":"#/components/schemas/V1CompanyInsiderSummary"},"recent_transactions":{"type":"array","items":{"$ref":"#/components/schemas/V1CompanyInsiderTx"}}},"required":["insider_summary","recent_transactions"]},"source_ids":{"type":"array","items":{"$ref":"#/components/schemas/V1CompanySourceId"}},"metadata":{"description":"Raw entity metadata JSON blob (mixed shape)"},"narrative":{"description":"Generated narrative summary for the company"},"aliases":{"description":"Alternative names / aliases for the entity"},"hierarchy":{"description":"GLEIF corporate parent-child hierarchy snapshot ({ parents, subsidiaries })"},"employee_contributions":{"description":"Aggregate contributions from employees of this company"}},"required":["id","name","type","state","ticker","sic_code","lei","uei","total_contributed","num_contributions","num_recipients","total_received","contribution_in_count","unique_donors","total_lobbying_income","total_lobbying_expense","num_lobbying_filings","total_contracts","num_contracts","influence_score","network_connectivity","first_activity_date","last_activity_date","top_recipients","lobbying","contracts","sec","source_ids"]},"V1CompanyDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1CompanyDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DonorSearchRow":{"type":"object","properties":{"sub_id":{"type":"number"},"donor_name":{"type":"string"},"donor_city":{"type":["string","null"]},"donor_state":{"type":["string","null"]},"donor_zip":{"type":["string","null"]},"employer":{"type":["string","null"]},"occupation":{"type":["string","null"]},"date":{"type":["string","null"]},"amount":{"type":"number"},"recipient_committee_id":{"type":["string","null"]},"recipient_name":{"type":["string","null"]},"cycle":{"type":"number"}},"required":["sub_id","donor_name","donor_city","donor_state","donor_zip","employer","occupation","date","amount","recipient_committee_id","recipient_name","cycle"]},"V1DonorSearchResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1DonorSearchRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DonorRecipient":{"type":"object","properties":{"recipient_name":{"type":"string"},"recipient_entity_id":{"type":"string"},"recipient_type":{"type":["string","null"]},"state":{"type":["string","null"]},"total":{"type":"number"},"num_contributions":{"type":"number"}},"required":["recipient_name","recipient_entity_id","recipient_type","state","total","num_contributions"]},"V1DonorCycleData":{"type":"object","properties":{"cycle":{"type":"number"},"total":{"type":"number"},"num_contributions":{"type":"number"}},"required":["cycle","total","num_contributions"]},"V1DonorCyclePartyData":{"type":"object","properties":{"cycle":{"type":"number"},"party":{"type":"string"},"total":{"type":"number"},"num_contributions":{"type":"number"},"num_recipients":{"type":"number"}},"required":["cycle","party","total","num_contributions","num_recipients"]},"V1DonorDetail":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["string","null"]},"state":{"type":["string","null"]},"party":{"type":["string","null"]},"total_contributed":{"type":["number","null"]},"num_contributions":{"type":["number","null"]},"num_recipients":{"type":["number","null"]},"avg_contribution":{"type":["number","null"]},"first_activity_date":{"type":["string","null"]},"last_activity_date":{"type":["string","null"]},"influence_score":{"type":["number","null"]},"employer":{"type":["string","null"],"description":"Employer — from entity metadata, falls back to most-frequent employer string in FIC"},"occupation":{"type":["string","null"],"description":"Occupation from entity metadata"},"active_period_start":{"type":["number","null"],"description":"Earliest cycle year minus 1 (first year of activity, derived from cycle data)"},"active_period_end":{"type":["number","null"],"description":"Latest cycle year of activity"},"party_totals":{"type":"object","additionalProperties":{"type":"number"},"description":"Aggregated contribution totals by recipient party (keys: \"Democrat\", \"Republican\", and any third-party labels)"},"narrative":{"type":["string","null"],"description":"Natural-language summary describing the donor's giving pattern, party lean, and top recipients"},"top_recipients":{"type":"array","items":{"$ref":"#/components/schemas/V1DonorRecipient"}},"by_cycle":{"type":"array","items":{"$ref":"#/components/schemas/V1DonorCycleData"}},"by_cycle_party":{"type":"array","items":{"$ref":"#/components/schemas/V1DonorCyclePartyData"},"description":"Per-cycle party breakdown for scatter/stacked charts"}},"required":["id","name","type","state","party","total_contributed","num_contributions","num_recipients","avg_contribution","first_activity_date","last_activity_date","influence_score","employer","occupation","active_period_start","active_period_end","party_totals","narrative","top_recipients","by_cycle","by_cycle_party"]},"V1DonorDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DonorDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LobbyingStatsData":{"type":"object","properties":{"client_count":{"type":"number"},"firm_count":{"type":"number"},"filing_count":{"type":"number"},"total_income":{"type":"number"},"total_expenses":{"type":"number"},"earliest_year":{"type":["number","null"]},"latest_year":{"type":["number","null"]}},"required":["client_count","firm_count","filing_count","total_income","total_expenses","earliest_year","latest_year"]},"V1LobbyingStatsResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1LobbyingStatsData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LobbyingClientSpendingYear":{"type":"object","properties":{"year":{"type":"number"},"total_spent":{"type":["number","null"]},"total_income":{"type":["number","null"]},"num_filings":{"type":"number"},"num_firms":{"type":"number"}},"required":["year","total_spent","total_income","num_filings","num_firms"]},"V1LobbyingClientIssue":{"type":"object","properties":{"issue_code":{"type":"string"},"num_reports":{"type":"number"}},"required":["issue_code","num_reports"]},"V1LobbyingClientFirm":{"type":"object","properties":{"firm_name":{"type":"string"},"entity_id":{"type":["string","null"],"description":"Entity UUID for the lobbying firm (if resolved)"},"total_paid":{"type":["number","null"]},"num_filings":{"type":"number"}},"required":["firm_name","entity_id","total_paid","num_filings"]},"V1LobbyingClientDetail":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":["string","null"],"description":"Entity UUID for the lobbying client (cross-link to get_company)"},"spending_by_year":{"type":"array","items":{"$ref":"#/components/schemas/V1LobbyingClientSpendingYear"}},"top_issues":{"type":"array","items":{"$ref":"#/components/schemas/V1LobbyingClientIssue"}},"hired_firms":{"type":"array","items":{"$ref":"#/components/schemas/V1LobbyingClientFirm"}}},"required":["name","spending_by_year","top_issues","hired_firms"]},"V1LobbyingClientDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1LobbyingClientDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LobbyingFirmRevenueYear":{"type":"object","properties":{"year":{"type":"number"},"revenue":{"type":["number","null"]},"total_expenses":{"type":["number","null"]},"num_filings":{"type":"number"},"num_clients":{"type":"number"}},"required":["year","revenue","total_expenses","num_filings","num_clients"]},"V1LobbyingFirmClient":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":["string","null"]},"total_paid":{"type":["number","null"]},"num_filings":{"type":"number"},"first_year":{"type":["number","null"]},"last_year":{"type":["number","null"]}},"required":["name","entity_id","total_paid","num_filings","first_year","last_year"]},"V1LobbyingFirmDetail":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["firm"]},"revenue_by_year":{"type":"array","items":{"$ref":"#/components/schemas/V1LobbyingFirmRevenueYear"}},"top_clients":{"type":"array","items":{"$ref":"#/components/schemas/V1LobbyingFirmClient"}},"top_issues":{"type":"array","items":{"$ref":"#/components/schemas/V1LobbyingClientIssue"}}},"required":["name","type","revenue_by_year","top_clients","top_issues"]},"V1LobbyingFirmDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1LobbyingFirmDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1TradeRow":{"type":"object","properties":{"trade_id":{"type":"number"},"filer_name":{"type":"string"},"chamber":{"type":["string","null"]},"bioguide_id":{"type":["string","null"]},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"photo_url":{"type":["string","null"]},"disclosure_date":{"type":["string","null"]},"transaction_date":{"type":["string","null"]},"ticker":{"type":["string","null"]},"asset_name":{"type":"string"},"asset_type":{"type":["string","null"]},"transaction_type":{"type":"string"},"amount_range":{"type":["string","null"]},"amount_low":{"type":["number","null"]},"amount_high":{"type":["number","null"]},"owner":{"type":["string","null"]},"filing_url":{"type":["string","null"]},"fec_candidate_id":{"type":["string","null"],"description":"FEC candidate ID of the filer (cross-link to get_politician)"},"politician_entity_id":{"type":["string","null"],"description":"Entity UUID of the filer/politician (cross-link to check_relationship)"},"company_entity_id":{"type":["string","null"],"description":"Entity UUID of the traded company (cross-link to get_company)"}},"required":["trade_id","filer_name","chamber","bioguide_id","party","state","photo_url","disclosure_date","transaction_date","ticker","asset_name","asset_type","transaction_type","amount_range","amount_low","amount_high","owner","filing_url"]},"V1TradesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TradeRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1TradesByPoliticianResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TradeRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1TradesByTickerResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1TradeRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1TradesSummaryData":{"type":"object","properties":{"totals":{"type":"object","properties":{"total_trades":{"type":"number"},"total_traders":{"type":"number"},"total_tickers":{"type":"number"},"earliest_trade":{"type":["string","null"]},"latest_trade":{"type":["string","null"]}},"required":["total_trades","total_traders","total_tickers","earliest_trade","latest_trade"]},"top_traders":{"type":"array","items":{"type":"object","properties":{"filer_name":{"type":"string"},"bioguide_id":{"type":["string","null"]},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"chamber":{"type":["string","null"]},"photo_url":{"type":["string","null"]},"trade_count":{"type":"number"},"estimated_volume":{"type":["number","null"]}},"required":["filer_name","bioguide_id","party","state","chamber","photo_url","trade_count","estimated_volume"]}},"top_tickers":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"trade_count":{"type":"number"},"trader_count":{"type":"number"},"buys":{"type":"number"},"sells":{"type":"number"}},"required":["ticker","trade_count","trader_count","buys","sells"]}}},"required":["totals","top_traders","top_tickers"]},"V1TradesSummaryResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1TradesSummaryData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1SpendingVendorRow":{"type":"object","properties":{"vendor_name":{"type":"string"},"committee_count":{"type":"number"},"total_across_committees":{"type":"number"},"total_disbursements":{"type":"number"}},"required":["vendor_name","committee_count","total_across_committees","total_disbursements"]},"V1SpendingVendorListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SpendingVendorRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1SpendingVendorDetail":{"type":"object","properties":{"name":{"type":"string"},"totals":{"type":"object","properties":{"total_amount":{"type":["number","null"]},"num_disbursements":{"type":"number"},"num_committees":{"type":"number"},"earliest_date":{"type":["string","null"]},"latest_date":{"type":["string","null"]}},"required":["total_amount","num_disbursements","num_committees","earliest_date","latest_date"]},"by_cycle":{"type":"array","items":{"type":"object","properties":{"cycle":{"type":"number"},"total_amount":{"type":"number"},"num_disbursements":{"type":"number"},"num_committees":{"type":"number"}},"required":["cycle","total_amount","num_disbursements","num_committees"]}},"top_committees":{"type":"array","items":{"type":"object","properties":{"cmte_id":{"type":["string","null"]},"committee_name":{"type":["string","null"]},"party":{"type":["string","null"]},"designation":{"type":["string","null"]},"total_amount":{"type":"number"},"num_disbursements":{"type":"number"}},"required":["cmte_id","committee_name","party","designation","total_amount","num_disbursements"]}},"top_purposes":{"type":"array","items":{"type":"object","properties":{"purpose":{"type":"string"},"total_amount":{"type":"number"},"num_disbursements":{"type":"number"}},"required":["purpose","total_amount","num_disbursements"]}}},"required":["name","totals","by_cycle","top_committees","top_purposes"]},"V1SpendingVendorDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1SpendingVendorDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1SpendingSummaryData":{"type":"object","properties":{"totals":{"type":"object","properties":{"total_disbursements":{"type":"number"},"total_amount":{"type":"number"},"total_committees":{"type":"number"},"total_vendors":{"type":"number"}},"required":["total_disbursements","total_amount","total_committees","total_vendors"]},"top_vendors":{"type":"array","items":{"$ref":"#/components/schemas/V1SpendingVendorRow"}},"by_cycle":{"type":"array","items":{"type":"object","properties":{"cycle":{"type":"number"},"total_amount":{"type":"number"},"num_disbursements":{"type":"number"}},"required":["cycle","total_amount","num_disbursements"]}}},"required":["totals","top_vendors","by_cycle"]},"V1SpendingSummaryResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1SpendingSummaryData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1ContractSearchRow":{"type":"object","properties":{"award_id":{"type":"string"},"recipient_name":{"type":["string","null"]},"awarding_agency_name":{"type":["string","null"]},"funding_agency_name":{"type":["string","null"]},"amount":{"type":["number","null"]},"fiscal_year":{"type":["number","null"]},"obligation_date":{"type":["string","null"]},"award_type":{"type":["string","null"]},"naics_code":{"type":["string","null"]},"naics_description":{"type":["string","null"]},"description":{"type":["string","null"]},"pop_state":{"type":["string","null"]},"pop_city":{"type":["string","null"]},"recipient_entity_id":{"type":["string","null"]}},"required":["award_id","recipient_name","awarding_agency_name","funding_agency_name","amount","fiscal_year","obligation_date","award_type","naics_code","naics_description","description","pop_state","pop_city","recipient_entity_id"]},"V1ContractSearchResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ContractSearchRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1ContractAgencyDetail":{"type":"object","properties":{"name":{"type":"string"},"totals":{"type":"object","properties":{"total_amount":{"type":["number","null"]},"num_awards":{"type":"number"},"num_recipients":{"type":"number"},"earliest_year":{"type":["number","null"]},"latest_year":{"type":["number","null"]}},"required":["total_amount","num_awards","num_recipients","earliest_year","latest_year"]},"by_year":{"type":"array","items":{"type":"object","properties":{"fiscal_year":{"type":"number"},"total_amount":{"type":"number"},"num_awards":{"type":"number"}},"required":["fiscal_year","total_amount","num_awards"]}},"top_recipients":{"type":"array","items":{"type":"object","properties":{"recipient_name":{"type":["string","null"]},"recipient_entity_id":{"type":["string","null"]},"total_amount":{"type":"number"},"num_awards":{"type":"number"}},"required":["recipient_name","recipient_entity_id","total_amount","num_awards"]}},"top_naics":{"type":"array","items":{"type":"object","properties":{"naics_code":{"type":"string"},"naics_description":{"type":["string","null"]},"total_amount":{"type":"number"},"num_awards":{"type":"number"}},"required":["naics_code","naics_description","total_amount","num_awards"]}}},"required":["name","totals","by_year","top_recipients","top_naics"]},"V1ContractAgencyDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1ContractAgencyDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1ContractAwardDetail":{"type":"object","properties":{"award_id":{"type":"string"},"award_type":{"type":["string","null"]},"recipient_name":{"type":["string","null"]},"recipient_uei":{"type":["string","null"]},"recipient_entity_id":{"type":["string","null"]},"awarding_agency_name":{"type":["string","null"]},"funding_agency_name":{"type":["string","null"]},"description":{"type":["string","null"]},"amount":{"type":["number","null"]},"total_outlays":{"type":["number","null"]},"obligation_date":{"type":["string","null"]},"start_date":{"type":["string","null"]},"end_date":{"type":["string","null"]},"contract_type":{"type":["string","null"]},"naics_code":{"type":["string","null"]},"naics_description":{"type":["string","null"]},"psc_code":{"type":["string","null"]},"psc_description":{"type":["string","null"]},"pop_city":{"type":["string","null"]},"pop_state":{"type":["string","null"]},"pop_zip":{"type":["string","null"]},"pop_country":{"type":["string","null"]},"fiscal_year":{"type":["number","null"]},"covid19_obligations":{"type":["number","null"]},"infrastructure_obligations":{"type":["number","null"]},"last_modified_date":{"type":["string","null"]}},"required":["award_id","award_type","recipient_name","recipient_uei","recipient_entity_id","awarding_agency_name","funding_agency_name","description","amount","total_outlays","obligation_date","start_date","end_date","contract_type","naics_code","naics_description","psc_code","psc_description","pop_city","pop_state","pop_zip","pop_country","fiscal_year","covid19_obligations","infrastructure_obligations","last_modified_date"]},"V1ContractAwardDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1ContractAwardDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LobbyingIssueCode":{"type":"object","properties":{"code":{"type":"string","description":"LDA general issue area code"},"name":{"type":"string","description":"Human-readable issue name"}},"required":["code","name"]},"V1LobbyingIssueListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1LobbyingIssueCode"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1SecSearchRow":{"type":"object","properties":{"accession_number":{"type":"string"},"cik":{"type":"string"},"form_type":{"type":"string"},"filing_date":{"type":["string","null"]},"company_name":{"type":["string","null"]},"ticker_symbol":{"type":["string","null"]},"company_entity_id":{"type":["string","null"],"description":"Entity UUID for the company (if resolved)"},"section_type":{"type":["string","null"]},"snippet":{"type":["string","null"]},"similarity":{"type":"number"}},"required":["accession_number","cik","form_type","filing_date","company_name","ticker_symbol","company_entity_id","section_type","snippet","similarity"]},"V1SecSearchResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SecSearchRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1SecFilingDetail":{"type":"object","properties":{"accession_number":{"type":"string"},"cik":{"type":"string"},"form_type":{"type":"string"},"filing_date":{"type":["string","null"]},"primary_document":{"type":["string","null"]},"primary_doc_description":{"type":["string","null"]},"company_name":{"type":["string","null"]},"ticker_symbol":{"type":["string","null"]},"company_entity_id":{"type":["string","null"],"description":"Entity UUID for the company (if resolved)"},"sic_code":{"type":["string","null"]},"sic_description":{"type":["string","null"]},"state_of_incorporation":{"type":["string","null"]},"sections":{"type":"array","items":{"type":"object","properties":{"section_type":{"type":"string"},"section_title":{"type":["string","null"]},"word_count":{"type":["number","null"]},"preview":{"type":["string","null"]}},"required":["section_type","section_title","word_count","preview"]}},"similar_filings":{"type":"array","items":{"type":"object","properties":{"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_date":{"type":["string","null"]},"company_name":{"type":["string","null"]},"ticker_symbol":{"type":["string","null"]},"company_entity_id":{"type":["string","null"]},"similarity":{"type":"number"}},"required":["accession_number","form_type","filing_date","company_name","ticker_symbol","company_entity_id","similarity"]}}},"required":["accession_number","cik","form_type","filing_date","primary_document","primary_doc_description","company_name","ticker_symbol","company_entity_id","sic_code","sic_description","state_of_incorporation","sections","similar_filings"]},"V1SecFilingDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1SecFilingDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1CongressionalCommitteeRow":{"type":"object","properties":{"committee_code":{"type":"string"},"committee_name":{"type":"string"},"chamber":{"type":["string","null"]},"bill_count":{"type":"number"},"activity_count":{"type":"number"},"earliest_activity":{"type":["string","null"]},"latest_activity":{"type":["string","null"]},"activity_types":{"type":["array","null"],"items":{"type":"string"}}},"required":["committee_code","committee_name","chamber","bill_count","activity_count","earliest_activity","latest_activity","activity_types"]},"V1CongressionalCommitteeListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1CongressionalCommitteeRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1CongressionalCommitteeDetail":{"type":"object","properties":{"committee_code":{"type":"string"},"committee_name":{"type":"string"},"chamber":{"type":["string","null"]},"bill_count":{"type":"number"},"earliest_activity":{"type":["string","null"]},"latest_activity":{"type":["string","null"]},"recent_bills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":["string","null"]},"congress":{"type":["number","null"]},"title":{"type":["string","null"]},"policy_area":{"type":["string","null"]},"status":{"type":["string","null"]},"became_law":{"type":["boolean","null"]},"latest_action_date":{"type":["string","null"]},"activity_type":{"type":["string","null"]},"activity_date":{"type":["string","null"]}},"required":["id","number","congress","title","policy_area","status","became_law","latest_action_date","activity_type","activity_date"]}},"top_policy_areas":{"type":"array","items":{"type":"object","properties":{"policy_area":{"type":"string"},"bill_count":{"type":"number"}},"required":["policy_area","bill_count"]}},"activity_by_type":{"type":"array","items":{"type":"object","properties":{"activity_type":{"type":"string"},"count":{"type":"number"}},"required":["activity_type","count"]}},"activity_by_year":{"type":"array","items":{"type":"object","properties":{"year":{"type":"number"},"bill_count":{"type":"number"}},"required":["year","bill_count"]}}},"required":["committee_code","committee_name","chamber","bill_count","earliest_activity","latest_activity","recent_bills","top_policy_areas","activity_by_type","activity_by_year"]},"V1CongressionalCommitteeDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1CongressionalCommitteeDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1PensionRow":{"type":"object","properties":{"plan_id":{"type":"number"},"ppd_id":{"type":"number"},"canonical_name":{"type":"string"},"short_name":{"type":["string","null"]},"state":{"type":["string","null"]},"plan_type":{"type":["string","null"]},"inception_year":{"type":["number","null"]},"entity_id":{"type":["string","null"],"format":"uuid"},"latest_fiscal_year":{"type":["number","null"]},"latest_market_assets":{"type":["number","null"]},"latest_funded_ratio":{"type":["number","null"]},"latest_return_1yr":{"type":["number","null"]},"active_members":{"type":["number","null"]},"retirees":{"type":["number","null"]},"total_membership":{"type":["number","null"]}},"required":["plan_id","ppd_id","canonical_name","short_name","state","plan_type","inception_year","entity_id","latest_fiscal_year","latest_market_assets","latest_funded_ratio","latest_return_1yr","active_members","retirees","total_membership"]},"V1PensionListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1PensionRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1PensionSummaryData":{"type":"object","properties":{"totals":{"type":"object","properties":{"total_plans":{"type":"number"},"states_covered":{"type":"number"},"earliest_inception":{"type":["number","null"]}},"required":["total_plans","states_covered","earliest_inception"]},"by_state":{"type":"array","items":{"type":"object","properties":{"state":{"type":"string"},"plan_count":{"type":"number"},"total_assets":{"type":["number","null"]},"avg_funded_ratio":{"type":["number","null"]}},"required":["state","plan_count","total_assets","avg_funded_ratio"]}},"by_type":{"type":"array","items":{"type":"object","properties":{"plan_type":{"type":"string"},"plan_count":{"type":"number"},"avg_funded_ratio":{"type":["number","null"]}},"required":["plan_type","plan_count","avg_funded_ratio"]}},"most_underfunded":{"type":"array","items":{"type":"object","properties":{"plan_id":{"type":"number"},"canonical_name":{"type":"string"},"state":{"type":"string"},"entity_id":{"type":["string","null"],"format":"uuid"},"funded_ratio":{"type":"number"},"market_assets":{"type":["number","null"]},"fiscal_year":{"type":"number"}},"required":["plan_id","canonical_name","state","entity_id","funded_ratio","market_assets","fiscal_year"]}}},"required":["totals","by_state","by_type","most_underfunded"]},"V1PensionSummaryResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1PensionSummaryData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1PensionFinancialRow":{"type":"object","properties":{"fiscal_year":{"type":"number"},"actuarial_assets":{"type":["number","null"]},"actuarial_liabilities":{"type":["number","null"]},"funded_ratio":{"type":["number","null"]},"uaal":{"type":["number","null"]},"market_assets":{"type":["number","null"]},"total_contributions":{"type":["number","null"]},"total_benefits_paid":{"type":["number","null"]},"investment_return_1yr":{"type":["number","null"]},"investment_return_5yr":{"type":["number","null"]},"investment_return_10yr":{"type":["number","null"]},"payroll":{"type":["number","null"]},"active_members":{"type":["number","null"]},"retirees":{"type":["number","null"]},"total_membership":{"type":["number","null"]}},"required":["fiscal_year","actuarial_assets","actuarial_liabilities","funded_ratio","uaal","market_assets","total_contributions","total_benefits_paid","investment_return_1yr","investment_return_5yr","investment_return_10yr","payroll","active_members","retirees","total_membership"]},"V1PensionAllocationRow":{"type":"object","properties":{"fiscal_year":{"type":"number"},"source":{"type":"string"},"equity_pct":{"type":["number","null"]},"fixed_income_pct":{"type":["number","null"]},"real_estate_pct":{"type":["number","null"]},"alternatives_pct":{"type":["number","null"]},"private_equity_pct":{"type":["number","null"]},"hedge_fund_pct":{"type":["number","null"]},"commodities_pct":{"type":["number","null"]},"cash_pct":{"type":["number","null"]}},"required":["fiscal_year","source","equity_pct","fixed_income_pct","real_estate_pct","alternatives_pct","private_equity_pct","hedge_fund_pct","commodities_pct","cash_pct"]},"V1PensionDetail":{"type":"object","properties":{"plan_id":{"type":"number"},"ppd_id":{"type":"number"},"canonical_name":{"type":"string"},"short_name":{"type":["string","null"]},"state":{"type":["string","null"]},"plan_type":{"type":["string","null"]},"inception_year":{"type":["number","null"]},"entity_id":{"type":["string","null"],"format":"uuid"},"metadata":{},"financials":{"type":"array","items":{"$ref":"#/components/schemas/V1PensionFinancialRow"}},"allocations":{"type":"array","items":{"$ref":"#/components/schemas/V1PensionAllocationRow"}}},"required":["plan_id","ppd_id","canonical_name","short_name","state","plan_type","inception_year","entity_id","financials","allocations"]},"V1PensionDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1PensionDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1PensionFinancialsData":{"type":"object","properties":{"plan_name":{"type":"string"},"plan_id":{"type":"number"},"years":{"type":"array","items":{"$ref":"#/components/schemas/V1PensionFinancialRow"}}},"required":["plan_name","plan_id","years"]},"V1PensionFinancialsResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1PensionFinancialsData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1PensionAllocationData":{"type":"object","properties":{"plan_name":{"type":"string"},"plan_id":{"type":"number"},"years":{"type":"array","items":{"$ref":"#/components/schemas/V1PensionAllocationRow"}}},"required":["plan_name","plan_id","years"]},"V1PensionAllocationResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1PensionAllocationData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1NonprofitRow":{"type":"object","properties":{"ein":{"type":"string"},"organization_name":{"type":"string"},"subsection_code":{"type":["string","null"]},"ntee_code":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]},"zip":{"type":["string","null"]},"asset_amount":{"type":["number","null"]},"income_amount":{"type":["number","null"]},"ruling_date":{"type":["string","null"]},"entity_id":{"type":["string","null"],"format":"uuid"}},"required":["ein","organization_name","subsection_code","ntee_code","state","city","zip","asset_amount","income_amount","ruling_date","entity_id"]},"V1NonprofitListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1NonprofitRow"}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1NonprofitSummaryData":{"type":"object","properties":{"totals":{"type":"object","properties":{"total_orgs":{"type":"number"},"states_covered":{"type":"number"},"total_assets":{"type":["number","null"]},"total_income":{"type":["number","null"]},"entity_linked":{"type":"number"}},"required":["total_orgs","states_covered","total_assets","total_income","entity_linked"]},"by_subsection":{"type":"array","items":{"type":"object","properties":{"subsection_code":{"type":"string"},"org_count":{"type":"number"},"total_assets":{"type":["number","null"]},"total_income":{"type":["number","null"]}},"required":["subsection_code","org_count","total_assets","total_income"]}},"by_state":{"type":"array","items":{"type":"object","properties":{"state":{"type":"string"},"org_count":{"type":"number"},"total_assets":{"type":["number","null"]}},"required":["state","org_count","total_assets"]}},"largest_by_assets":{"type":"array","items":{"$ref":"#/components/schemas/V1NonprofitRow"}}},"required":["totals","by_subsection","by_state","largest_by_assets"]},"V1NonprofitSummaryResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1NonprofitSummaryData"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1NonprofitSearchResponse":{"type":"object","properties":{"data":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/V1NonprofitRow"},{"type":"object","properties":{"score":{"type":"number"}}}]}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1NonprofitDetail":{"type":"object","properties":{"ein":{"type":"string"},"organization_name":{"type":"string"},"subsection_code":{"type":["string","null"]},"ntee_code":{"type":["string","null"]},"ruling_date":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]},"zip":{"type":["string","null"]},"asset_amount":{"type":["number","null"]},"income_amount":{"type":["number","null"]},"is_politically_active":{"type":["boolean","null"]},"entity_id":{"type":["string","null"],"format":"uuid"},"metadata":{},"filings":{"type":"array","items":{"type":"object","properties":{"object_id":{"type":"string"},"tax_period":{"type":["string","null"]},"form_type":{"type":["string","null"]},"tax_year":{"type":["number","null"]},"total_revenue":{"type":["number","null"]},"total_expenses":{"type":["number","null"]},"net_assets":{"type":["number","null"]}},"required":["object_id","tax_period","form_type","tax_year","total_revenue","total_expenses","net_assets"]}},"grants_paid":{"type":"array","items":{"type":"object","properties":{"recipient_name":{"type":["string","null"]},"recipient_ein":{"type":["string","null"]},"grant_amount":{"type":["number","null"]},"grant_purpose":{"type":["string","null"]},"tax_year":{"type":["number","null"]},"recipient_entity_id":{"type":["string","null"],"format":"uuid"}},"required":["recipient_name","recipient_ein","grant_amount","grant_purpose","tax_year","recipient_entity_id"]}},"officers":{"type":"array","items":{"type":"object","properties":{"person_name":{"type":["string","null"]},"title":{"type":["string","null"]},"total_comp":{"type":["number","null"]},"tax_year":{"type":["number","null"]},"person_entity_id":{"type":["string","null"],"format":"uuid"}},"required":["person_name","title","total_comp","tax_year","person_entity_id"]}}},"required":["ein","organization_name","subsection_code","ntee_code","ruling_date","state","city","zip","asset_amount","income_amount","is_politically_active","entity_id","filings","grants_paid","officers"]},"V1NonprofitDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1NonprofitDetail"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1NonprofitGrantsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"recipient_name":{"type":["string","null"]},"recipient_ein":{"type":["string","null"]},"grant_amount":{"type":["number","null"]},"grant_purpose":{"type":["string","null"]},"tax_year":{"type":["number","null"]},"is_political_org":{"type":["boolean","null"]},"recipient_entity_id":{"type":["string","null"],"format":"uuid"},"recipient_city":{"type":["string","null"],"description":"Recipient city"},"recipient_state":{"type":["string","null"],"description":"Recipient state"},"grant_type":{"type":["string","null"],"description":"Grant type (cash, non-cash, etc.)"},"grantor_entity_id":{"type":["string","null"],"format":"uuid","description":"Entity UUID for the grantor nonprofit"},"recipient_org_name":{"type":["string","null"],"description":"Recipient organization name from dim_nonprofit join"},"recipient_subsection":{"type":["string","null"],"description":"IRS 501(c) subsection code of the recipient"}},"required":["recipient_name","recipient_ein","grant_amount","grant_purpose","tax_year","is_political_org","recipient_entity_id"]}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1NonprofitOfficersResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"person_name":{"type":["string","null"]},"title":{"type":["string","null"]},"avg_hours_per_week":{"type":["number","null"]},"is_officer":{"type":["boolean","null"]},"is_director":{"type":["boolean","null"]},"is_trustee":{"type":["boolean","null"]},"is_key_employee":{"type":["boolean","null"]},"is_former":{"type":["boolean","null"],"description":"Whether this officer is a former (not current) officer"},"reportable_comp":{"type":["number","null"]},"other_comp":{"type":["number","null"]},"total_comp":{"type":["number","null"]},"person_entity_id":{"type":["string","null"],"format":"uuid"},"tax_year":{"type":["number","null"]}},"required":["person_name","title","avg_hours_per_week","is_officer","is_director","is_trustee","is_key_employee","reportable_comp","other_comp","total_comp","person_entity_id","tax_year"]}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1ResolveResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"entity_id":{"type":"string","format":"uuid"},"canonical_name":{"type":"string"},"entity_type":{"type":"string"},"matched_name":{"type":"string"},"match_source":{"type":"string","enum":["alias","canonical"]},"score":{"type":"number"}},"required":["entity_id","canonical_name","entity_type","matched_name","match_source","score"]}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1RelationshipResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"entities":{"type":"object","additionalProperties":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["name","type"]}},"donations":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"total":{"type":"number"},"count":{"type":"number"},"cycles":{"type":"array","items":{"type":"number"}}},"required":["from","to","total","count","cycles"]}},"shared_lobbying_issues":{"type":"array","items":{"type":"string"}},"relationship_metrics":{"type":"array","items":{"type":"object","properties":{"relationship_type":{"type":"string"},"weight":{"type":["number","null"]},"edge_count":{"type":["number","null"]},"first_date":{"type":["string","null"]},"last_date":{"type":["string","null"]}},"required":["relationship_type","weight","edge_count","first_date","last_date"]}},"has_relationship":{"type":"boolean"}},"required":["entities","donations","shared_lobbying_issues","relationship_metrics","has_relationship"]},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1LobbyingByTopicResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"topic":{"type":"string"},"matched_issue_codes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]}},"matched_by":{"type":"string","enum":["issue_code","text_search"]},"clients":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":["string","null"]},"total_spent":{"type":"number"},"filing_count":{"type":"number"}},"required":["name","entity_id","total_spent","filing_count"]}},"firms":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":["string","null"]},"total_revenue":{"type":"number"},"num_clients":{"type":"number"}},"required":["name","entity_id","total_revenue","num_clients"]}},"total_spend":{"type":"number"}},"required":["topic","matched_issue_codes","matched_by","clients","total_spend"]},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1BillSemanticResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":["string","null"]},"congress":{"type":"number"},"type":{"type":["string","null"]},"title":{"type":["string","null"]},"policy_area":{"type":["string","null"]},"latest_action_date":{"type":["string","null"]},"became_law":{"type":"boolean"},"summary":{"type":["string","null"]},"primary_sponsor":{"type":["string","null"]},"similarity":{"type":"number"}},"required":["id","number","congress","type","title","policy_area","latest_action_date","became_law","summary","primary_sponsor","similarity"]}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1BillLobbyingResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"bill_id":{"type":"string"},"policy_area":{"type":["string","null"]},"matched_issues":{"type":"array","items":{"type":"string"}},"lobbying":{"type":"array","items":{"type":"object","properties":{"client_name":{"type":"string"},"client_entity_id":{"type":["string","null"]},"registrant_name":{"type":"string"},"registrant_entity_id":{"type":["string","null"]},"total_amount":{"type":"number"},"filing_count":{"type":"number"},"first_year":{"type":"number"},"last_year":{"type":"number"}},"required":["client_name","client_entity_id","registrant_name","registrant_entity_id","total_amount","filing_count","first_year","last_year"]}}},"required":["bill_id","policy_area","matched_issues","lobbying"]},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1BillSponsorFundingResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"bill_id":{"type":"string"},"sponsor":{"type":["object","null"],"properties":{"name":{"type":"string"},"bioguide_id":{"type":"string"},"party":{"type":"string"},"state":{"type":"string"},"entity_id":{"type":"string"}},"required":["name","bioguide_id","party","state","entity_id"]},"funding":{"type":["object","null"],"properties":{"total_raised":{"type":"number"},"num_contributions":{"type":"number"},"num_donors":{"type":"number"},"top_donors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"entity_id":{"type":"string"},"total":{"type":"number"}},"required":["name","entity_id","total"]}},"top_industries":{"type":"array","items":{"type":"object","properties":{"industry":{"type":"string"},"total":{"type":"number"},"num_donors":{"type":"number"}},"required":["industry","total","num_donors"]}}},"required":["total_raised","num_contributions","num_donors","top_donors","top_industries"]}},"required":["bill_id","sponsor","funding"]},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1BillActionsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"action_date":{"type":["string","null"]},"action_text":{"type":"string"},"action_type":{"type":"string"},"chamber":{"type":"string"},"action_code":{"type":["string","null"]},"source_system":{"type":["string","null"]},"committee_name":{"type":["string","null"]}},"required":["action_date","action_text","action_type","chamber","action_code","source_system","committee_name"]}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1CoworkersResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"donor_entity_id":{"type":"string"},"donor_name":{"type":["string","null"]},"employer":{"type":["string","null"]},"coworkers":{"type":"array","items":{"type":"object","properties":{"entity_id":{"type":"string"},"name":{"type":"string"},"occupation":{"type":["string","null"]},"total_contributed":{"type":"number"},"num_contributions":{"type":"number"},"num_recipients":{"type":"number"},"shared_recipients":{"type":["number","null"]}},"required":["entity_id","name","occupation","total_contributed","num_contributions","num_recipients","shared_recipients"]}}},"required":["donor_entity_id","donor_name","employer","coworkers"]},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1ContractDependencyResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"entity_id":{"type":"string"},"name":{"type":"string"},"entity_type":{"type":"string"},"summary":{"type":"object","properties":{"total_contract_value":{"type":"number"},"total_awards":{"type":"number"},"num_agencies":{"type":"number"},"top_agency_concentration":{"type":["number","null"]},"influence_score":{"type":["number","null"]}},"required":["total_contract_value","total_awards","num_agencies","top_agency_concentration","influence_score"]},"top_agencies":{"type":"array","items":{"type":"object","properties":{"agency":{"type":"string"},"award_count":{"type":"number"},"total_value":{"type":"number"},"first_award":{"type":["string","null"]},"last_award":{"type":["string","null"]}},"required":["agency","award_count","total_value","first_award","last_award"]}},"by_year":{"type":"array","items":{"type":"object","properties":{"year":{"type":"number"},"award_count":{"type":"number"},"total_value":{"type":"number"}},"required":["year","award_count","total_value"]}}},"required":["entity_id","name","entity_type","summary","top_agencies","by_year"]},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DarkMoneyListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"trace_id":{"type":"string"},"source_ein":{"type":"string"},"source_name":{"type":"string"},"source_entity_id":{"type":["string","null"]},"destination_cmte_id":{"type":"string"},"destination_name":{"type":"string"},"destination_entity_id":{"type":["string","null"]},"grant_amount":{"type":"number"},"tax_year":{"type":"number"},"match_confidence":{"type":"number"},"match_method":{"type":"string"},"source_subsection":{"type":["string","null"],"description":"IRS 501(c) subsection code for the source nonprofit"},"intermediate_ein":{"type":["string","null"],"description":"EIN of intermediate nonprofit in a multi-hop trace"},"intermediate_name":{"type":["string","null"],"description":"Name of intermediate nonprofit in a multi-hop trace"},"intermediate_entity_id":{"type":["string","null"],"description":"Entity UUID of the intermediate nonprofit"},"fec_contribution_amount":{"type":["number","null"],"description":"FEC-reported contribution amount from source/intermediate to destination committee"},"fec_cycle":{"type":["number","null"],"description":"FEC election cycle for the contribution"},"total_ie_spending":{"type":["number","null"],"description":"Total independent expenditure spending by the destination committee in the cycle"},"candidates_supported":{"type":["array","null"],"items":{"type":"string"},"description":"Candidates supported by the destination committee"},"candidates_opposed":{"type":["array","null"],"items":{"type":"string"},"description":"Candidates opposed by the destination committee"}},"required":["trace_id","source_ein","source_name","source_entity_id","destination_cmte_id","destination_name","destination_entity_id","grant_amount","tax_year","match_confidence","match_method"]}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DarkMoneySummaryResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"total_traces":{"type":"number"},"total_grant_amount":{"type":"number"},"unique_sources":{"type":"number"},"unique_destinations":{"type":"number"}},"required":["total_traces","total_grant_amount","unique_sources","unique_destinations"]},"by_year":{"type":"array","items":{"type":"object","properties":{"tax_year":{"type":"number"},"trace_count":{"type":"number"},"grant_amount":{"type":"number"}},"required":["tax_year","trace_count","grant_amount"]}},"top_sources":{"type":"array","items":{"type":"object","properties":{"source_ein":{"type":"string"},"source_name":{"type":"string"},"trace_count":{"type":"number"},"total_grant_amount":{"type":"number"}},"required":["source_ein","source_name","trace_count","total_grant_amount"]}},"top_destinations":{"type":"array","items":{"type":"object","properties":{"destination_cmte_id":{"type":"string"},"destination_name":{"type":"string"},"trace_count":{"type":"number"},"total_received":{"type":"number"}},"required":["destination_cmte_id","destination_name","trace_count","total_received"]}},"by_method":{"type":"array","items":{"type":"object","properties":{"match_method":{"type":["string","null"]},"trace_count":{"type":"number"},"total_grant_amount":{"type":["number","null"]},"avg_confidence":{"type":["number","null"]}},"required":["match_method","trace_count","total_grant_amount","avg_confidence"]},"description":"Breakdown of traces by matching method"}},"required":["totals","by_year","top_sources","top_destinations"]},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DarkMoneySearchResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"trace_id":{"type":"string"},"source_name":{"type":"string"},"destination_name":{"type":"string"},"grant_amount":{"type":"number"},"tax_year":{"type":"number"},"match_confidence":{"type":"number"},"source_ein":{"type":["string","null"],"description":"Source nonprofit EIN"},"source_entity_id":{"type":["string","null"],"description":"Entity UUID of the source nonprofit"},"source_subsection":{"type":["string","null"],"description":"IRS 501(c) subsection code for the source nonprofit"},"intermediate_name":{"type":["string","null"],"description":"Name of intermediate nonprofit in a multi-hop trace"},"intermediate_entity_id":{"type":["string","null"],"description":"Entity UUID of the intermediate nonprofit"},"destination_cmte_id":{"type":["string","null"],"description":"Destination committee FEC ID"},"destination_entity_id":{"type":["string","null"],"description":"Entity UUID of the destination committee"},"fec_contribution_amount":{"type":["number","null"],"description":"FEC-reported contribution amount"},"fec_cycle":{"type":["number","null"],"description":"FEC election cycle"},"total_ie_spending":{"type":["number","null"],"description":"Total independent expenditure spending by destination in the cycle"},"match_method":{"type":["string","null"],"description":"Method used to match source-to-destination"},"score":{"type":["number","null"],"description":"Trigram similarity score for the fuzzy match"}},"required":["trace_id","source_name","destination_name","grant_amount","tax_year","match_confidence"]}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DarkMoneySourceResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"nonprofit":{"type":["object","null"],"properties":{"ein":{"type":"string"},"organization_name":{"type":"string"},"entity_id":{"type":["string","null"]},"state":{"type":["string","null"]}},"required":["ein","organization_name","entity_id","state"]},"traces":{"type":"array","items":{}},"totals":{"type":"object","properties":{"trace_count":{"type":"number"},"total_grant_amount":{"type":"number"},"unique_recipients":{"type":"number"}},"required":["trace_count","total_grant_amount","unique_recipients"]},"recipients":{"type":"array","items":{"type":"object","properties":{"cmte_id":{"type":"string"},"name":{"type":"string"},"entity_id":{"type":["string","null"]},"total":{"type":"number"}},"required":["cmte_id","name","entity_id","total"]}},"filing_summary":{"type":"array","items":{"type":"object","properties":{"tax_year":{"type":["number","null"]},"total_revenue":{"type":["number","null"]},"total_expenses":{"type":["number","null"]},"net_assets":{"type":["number","null"]},"political_expenditures":{"type":["number","null"]},"lobbying_expenditures":{"type":["number","null"]},"total_grants_paid":{"type":["number","null"]}},"required":["tax_year","total_revenue","total_expenses","net_assets","political_expenditures","lobbying_expenditures","total_grants_paid"]},"description":"Summary of 990 filings for this nonprofit across tax years"}},"required":["nonprofit","traces","totals","recipients"]},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DarkMoneyDestinationResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"committee":{"type":["object","null"],"properties":{"cmte_id":{"type":"string"},"cmte_name":{"type":"string"},"entity_id":{"type":["string","null"]}},"required":["cmte_id","cmte_name","entity_id"]},"traces":{"type":"array","items":{}},"totals":{"type":"object","properties":{"trace_count":{"type":"number"},"total_dark_money_received":{"type":"number"},"unique_sources":{"type":"number"}},"required":["trace_count","total_dark_money_received","unique_sources"]},"sources":{"type":"array","items":{"type":"object","properties":{"ein":{"type":"string"},"name":{"type":"string"},"entity_id":{"type":["string","null"]},"total":{"type":"number"}},"required":["ein","name","entity_id","total"]}},"candidates_supported":{"type":"array","items":{"type":"string"}},"candidates_opposed":{"type":"array","items":{"type":"string"}}},"required":["committee","traces","totals","sources","candidates_supported","candidates_opposed"]},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1GiftListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Filing ID"},"chamber":{"type":["string","null"]},"filer_name":{"type":["string","null"]},"filer_last_name":{"type":["string","null"]},"filer_first_name":{"type":["string","null"]},"office":{"type":["string","null"]},"bioguide_id":{"type":["string","null"],"description":"Legislator bioguide ID (cross-link to get_legislator)"},"fec_candidate_id":{"type":["string","null"],"description":"Linked FEC candidate ID (cross-link to get_politician)"},"legislator_entity_id":{"type":["string","null"],"description":"Entity UUID for the filer/legislator"},"filing_type":{"type":["string","null"]},"reporting_year":{"type":["number","null"]},"filing_date":{"type":["string","null"]},"gift_source":{"type":["string","null"]},"gift_description":{"type":["string","null"]},"gift_value":{"type":["number","null"]},"travel_sponsor":{"type":["string","null"]},"travel_destination":{"type":["string","null"]},"travel_departure_date":{"type":["string","null"]},"travel_return_date":{"type":["string","null"]},"travel_purpose":{"type":["string","null"]},"travel_total_value":{"type":["number","null"]},"pdf_url":{"type":["string","null"]}}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1GiftDetailResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"filing_id":{"type":["number","null"]},"chamber":{"type":["string","null"]},"filer_last_name":{"type":["string","null"]},"filer_first_name":{"type":["string","null"]},"filer_name":{"type":["string","null"]},"filer_suffix":{"type":["string","null"]},"office":{"type":["string","null"]},"bioguide_id":{"type":["string","null"],"description":"Legislator bioguide ID"},"legislator_entity_id":{"type":["string","null"],"description":"Entity UUID for the filer/legislator"},"filing_type":{"type":["string","null"]},"reporting_period":{"type":["string","null"]},"reporting_year":{"type":["number","null"]},"filing_date":{"type":["string","null"]},"gift_source":{"type":["string","null"]},"gift_description":{"type":["string","null"]},"gift_value":{"type":["number","null"]},"gift_date":{"type":["string","null"]},"travel_sponsor":{"type":["string","null"]},"travel_destination":{"type":["string","null"]},"travel_departure_date":{"type":["string","null"]},"travel_return_date":{"type":["string","null"]},"travel_purpose":{"type":["string","null"]},"travel_lodging":{"type":["number","null"]},"travel_meals":{"type":["number","null"]},"travel_transportation":{"type":["number","null"]},"travel_total_value":{"type":["number","null"]},"pdf_url":{"type":["string","null"]},"source_url":{"type":["string","null"]},"source":{"type":["string","null"]},"raw_data":{},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]},"sponsor_entity_id":{"type":["string","null"],"description":"Entity UUID for the gift/travel sponsor"},"legislator_name":{"type":["string","null"]},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"fec_candidate_id":{"type":["string","null"],"description":"FEC candidate ID of the filer (cross-link to get_politician)"}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1GiftMembersResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"filer_name":{"type":["string","null"]},"chamber":{"type":["string","null"]},"bioguide_id":{"type":["string","null"],"description":"Legislator bioguide ID (cross-link to get_legislator)"},"office":{"type":["string","null"]},"fec_candidate_id":{"type":["string","null"],"description":"FEC candidate ID (cross-link to get_politician)"},"entity_id":{"type":["string","null"],"description":"Entity UUID for the filer/legislator"},"filing_count":{"type":["number","null"]},"travel_count":{"type":["number","null"]},"gift_count":{"type":["number","null"]},"earliest_year":{"type":["number","null"]},"latest_year":{"type":["number","null"]}}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1GiftSponsorsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"sponsor":{"type":["string","null"],"description":"Sponsor/gift-source name (travel_sponsor or gift_source)"},"filing_count":{"type":["number","null"]},"filer_count":{"type":["number","null"]},"chambers":{"type":["array","null"],"items":{"type":"string"},"description":"Chambers (house/senate) that filed with this sponsor"},"earliest_year":{"type":["number","null"]},"latest_year":{"type":["number","null"]}}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1GiftSummaryResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"total_filings":{"type":["number","null"]},"total_filers":{"type":["number","null"]},"house_filings":{"type":["number","null"]},"senate_filings":{"type":["number","null"]},"travel_filings":{"type":["number","null"]},"non_travel_filings":{"type":["number","null"]},"earliest_year":{"type":["number","null"]},"latest_year":{"type":["number","null"]}},"description":"Top-line counts across all filings"},"by_chamber":{"type":"array","items":{"type":"object","properties":{"chamber":{"type":["string","null"]},"filing_count":{"type":["number","null"]},"filer_count":{"type":["number","null"]}},"required":["chamber","filing_count","filer_count"]},"description":"Breakdown by chamber"},"by_year":{"type":"array","items":{"type":"object","properties":{"year":{"type":["number","null"]},"chamber":{"type":["string","null"]},"filing_count":{"type":["number","null"]}},"required":["year","chamber","filing_count"]},"description":"Filings by year and chamber"},"by_type":{"type":"array","items":{"type":"object","properties":{"filing_type":{"type":["string","null"]},"chamber":{"type":["string","null"]},"filing_count":{"type":["number","null"]}},"required":["filing_type","chamber","filing_count"]},"description":"Filings by type and chamber"}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1AppointeeListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Appointee ID"},"name":{"type":["string","null"],"description":"Full name"},"agency":{"type":["string","null"],"description":"Agency"},"component":{"type":["string","null"],"description":"Sub-agency/component"},"position_title":{"type":["string","null"],"description":"Position title"},"appointment_type":{"type":["string","null"],"description":"Appointment type"},"administration":{"type":["string","null"],"description":"Administration (e.g. \"Biden\", \"Trump\")"},"entity_id":{"type":["string","null"],"description":"Entity UUID for cross-linking"},"filing_count":{"type":"number","description":"Number of financial disclosure filings"},"latest_filing":{"type":["string","null"],"description":"Latest filing date"}}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1AppointeeDetailResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"number","description":"Appointee ID"},"name":{"type":["string","null"]},"agency":{"type":["string","null"]},"component":{"type":["string","null"]},"position_title":{"type":["string","null"]},"appointment_type":{"type":["string","null"]},"pay_plan":{"type":["string","null"]},"level_grade":{"type":["string","null"]},"location":{"type":["string","null"]},"tenure":{"type":["string","null"]},"start_date":{"type":["string","null"]},"end_date":{"type":["string","null"]},"administration":{"type":["string","null"]},"entity_id":{"type":["string","null"],"description":"Entity UUID for cross-linking"},"plum_incumbent_id":{"type":["string","null"],"description":"Plum Book incumbent ID"},"summary":{"type":"object","properties":{"filing_count":{"type":"number"},"asset_count":{"type":"number"},"position_count":{"type":"number"},"transaction_count":{"type":"number"},"liability_count":{"type":"number"},"estimated_assets_min":{"type":"number"},"estimated_assets_max":{"type":"number"},"estimated_liabilities_min":{"type":"number"},"estimated_liabilities_max":{"type":"number"}},"description":"Aggregate summary statistics across filings"},"filings":{"type":"array","items":{},"description":"All OGE financial disclosure filings"},"assets":{"type":"array","items":{},"description":"Parsed asset rows across filings"},"positions":{"type":"array","items":{},"description":"Parsed outside positions held"},"transactions":{"type":"array","items":{},"description":"Parsed financial transactions"},"liabilities":{"type":"array","items":{},"description":"Parsed liabilities"},"compensation":{"type":"array","items":{},"description":"Parsed non-government compensation"},"gifts":{"type":"array","items":{},"description":"Parsed gifts received"}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DisclosureFilingResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"number","description":"Disclosure filing ID"},"appointee_id":{"type":["number","null"]},"filer_name":{"type":["string","null"]},"agency":{"type":["string","null"]},"position_title":{"type":["string","null"]},"disclosure_type":{"type":["string","null"]},"filing_date":{"type":["string","null"]},"date_added":{"type":["string","null"]},"calendar_year":{"type":["number","null"]},"level":{"type":["string","null"]},"pdf_url":{"type":["string","null"]},"parsed":{},"source":{"type":["string","null"]},"appointee_name":{"type":["string","null"]},"administration":{"type":["string","null"]},"assets":{"type":"array","items":{}},"positions":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"liabilities":{"type":"array","items":{}},"compensation":{"type":"array","items":{}},"gifts":{"type":"array","items":{}},"endnotes":{"type":"array","items":{}}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DisclosureSearchResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"assets":{"type":"array","items":{},"description":"Matching asset rows"},"positions":{"type":"array","items":{},"description":"Matching outside-position rows"},"transactions":{"type":"array","items":{},"description":"Matching transaction rows"},"compensation":{"type":"array","items":{},"description":"Matching compensation rows"}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DisclosureSummaryResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"totals":{"type":"object","properties":{"total_appointees":{"type":["number","null"]},"total_filings":{"type":["number","null"]},"total_assets":{"type":["number","null"]},"total_tickers":{"type":["number","null"]}},"description":"Top-line counts"},"top_agencies":{"type":"array","items":{"type":"object","properties":{"agency":{"type":["string","null"]},"appointee_count":{"type":["number","null"]},"filing_count":{"type":["number","null"]}},"required":["agency","appointee_count","filing_count"]},"description":"Agencies with most appointees"},"top_tickers":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":["string","null"]},"holder_count":{"type":["number","null"]},"holding_count":{"type":["number","null"]},"total_value_max":{"type":["number","null"]}},"required":["ticker","holder_count","holding_count","total_value_max"]},"description":"Stock tickers most held across disclosures"},"filings_by_type":{"type":"array","items":{"type":"object","properties":{"disclosure_type":{"type":["string","null"]},"filing_count":{"type":["number","null"]}},"required":["disclosure_type","filing_count"]},"description":"Filing count by disclosure type"}}},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1CompanyHierarchy":{"type":"object","properties":{"nodes":{"description":"Hierarchy nodes (entities) with names, LEIs, influence scores, and depth"},"edges":{"description":"Parent-child relationship edges between nodes"},"root":{"description":"Root entity metadata ({ entity_id, lei, canonical_name }) or null if no LEI"}}},"V1CompanyHierarchyResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1CompanyHierarchy"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1DonorsByEmployer":{"type":"object","properties":{"employer":{"type":"string","description":"Employer name that was queried"},"total_contributed":{"type":["number","null"],"description":"Total dollars contributed by employees of this employer"},"num_contributions":{"type":"number","description":"Total number of contribution transactions"},"num_donors":{"type":"number","description":"Count of unique donor entities employed at this employer"},"first_contribution":{"type":["string","null"],"description":"Earliest contribution date (ISO)"},"last_contribution":{"type":["string","null"],"description":"Latest contribution date (ISO)"},"top_recipients":{"description":"Top political recipients (committees) receiving contributions from employees"},"by_cycle":{"description":"Aggregate totals grouped by election cycle"}}},"V1DonorsByEmployerResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DonorsByEmployer"},"meta":{"$ref":"#/components/schemas/V1Meta"}},"required":["data","meta"]},"V1ElectionCycleSummary":{"type":"object","properties":{"cycle":{"type":"number"},"total_raised":{"type":"number"},"total_donors":{"type":"number"},"total_transactions":{"type":"number"},"individual_total":{"type":["number","null"]},"organization_total":{"type":["number","null"]}},"required":["cycle","total_raised","total_donors","total_transactions","individual_total","organization_total"]},"V1ElectionsOverviewData":{"type":"object","properties":{"by_cycle":{"type":"array","items":{"$ref":"#/components/schemas/V1ElectionCycleSummary"}}},"required":["by_cycle"]},"V1ElectionsMeta":{"type":"object","properties":{"limit":{"type":"number"},"offset":{"type":"number"},"cycle":{"type":"number"},"source":{"type":"string"}},"required":["source"]},"V1ElectionsOverviewResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1ElectionsOverviewData"},"meta":{"$ref":"#/components/schemas/V1ElectionsMeta"}},"required":["data","meta"]},"V1ElectionsError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"V1ElectionRaceRow":{"type":"object","properties":{"office":{"type":"string"},"state":{"type":["string","null"]},"district":{"type":["string","null"]},"cycle":{"type":"number"},"num_candidates":{"type":"number"},"total_raised":{"type":"number"},"total_spent":{"type":"number"},"top_fundraiser":{"type":["string","null"]},"top_fundraiser_id":{"type":["string","null"],"description":"FEC candidate ID of the top fundraiser (cross-link to get_politician)"}},"required":["office","state","district","cycle","num_candidates","total_raised","total_spent","top_fundraiser"]},"V1ElectionRacesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ElectionRaceRow"}},"meta":{"$ref":"#/components/schemas/V1ElectionsMeta"}},"required":["data","meta"]},"V1StateTotalRow":{"type":"object","properties":{"state":{"type":"string"},"cycle":{"type":"number"},"total_amount":{"type":"number"},"individual_amount":{"type":["number","null"]},"org_amount":{"type":["number","null"]},"donor_count":{"type":"number"},"transaction_count":{"type":"number"},"avg_amount":{"type":["number","null"]}},"required":["state","cycle","total_amount","individual_amount","org_amount","donor_count","transaction_count","avg_amount"]},"V1StateTotalsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1StateTotalRow"}},"meta":{"$ref":"#/components/schemas/V1ElectionsMeta"}},"required":["data","meta"]},"V1ZipCodeRow":{"type":"object","properties":{"zip_code":{"type":"string"},"state":{"type":"string"},"total_amount":{"type":"number"},"transaction_count":{"type":"number"},"unique_donors":{"type":"number"},"avg_amount":{"type":["number","null"]}},"required":["zip_code","state","total_amount","transaction_count","unique_donors","avg_amount"]},"V1ZipCodesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1ZipCodeRow"}},"meta":{"$ref":"#/components/schemas/V1ElectionsMeta"}},"required":["data","meta"]},"V1EmployerTotalRow":{"type":"object","properties":{"employer":{"type":"string"},"total_contributions":{"type":"number"},"total_transactions":{"type":"number"},"unique_donors":{"type":"number"},"num_recipients":{"type":"number"}},"required":["employer","total_contributions","total_transactions","unique_donors","num_recipients"]},"V1EmployerTotalsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1EmployerTotalRow"}},"meta":{"$ref":"#/components/schemas/V1ElectionsMeta"}},"required":["data","meta"]},"V1SpendingTrendRow":{"type":"object","properties":{"date":{"type":"string","description":"Period start date — ISO date. For \"daily\" granularity this is the actual day; for \"monthly\" it is the first day of the month."},"total_contributions":{"type":"number"},"contribution_count":{"type":"number"},"unique_donors":{"type":"number"},"avg_contribution":{"type":["number","null"]}},"required":["date","total_contributions","contribution_count","unique_donors","avg_contribution"]},"V1SpendingTrendsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SpendingTrendRow"}},"meta":{"$ref":"#/components/schemas/V1ElectionsMeta"}},"required":["data","meta"]},"V1OutsideSpendingSummary":{"type":"object","properties":{"total_expenditures":{"type":"number"},"total_amount":{"type":"number"},"total_support":{"type":["number","null"]},"total_oppose":{"type":["number","null"]},"unique_spenders":{"type":"number"},"unique_targets":{"type":"number"}},"required":["total_expenditures","total_amount","total_support","total_oppose","unique_spenders","unique_targets"]},"V1OutsideSpender":{"type":"object","properties":{"spender_name":{"type":["string","null"]},"spender_entity_id":{"type":["string","null"]},"spender_cmte_id":{"type":["string","null"]},"total_spent":{"type":"number"},"num_expenditures":{"type":"number"},"num_targets":{"type":"number"},"support_spending":{"type":["number","null"]},"oppose_spending":{"type":["number","null"]}},"required":["spender_name","spender_entity_id","spender_cmte_id","total_spent","num_expenditures","num_targets","support_spending","oppose_spending"]},"V1OutsideSpendingData":{"type":"object","properties":{"summary":{"$ref":"#/components/schemas/V1OutsideSpendingSummary"},"top_spenders":{"type":"array","items":{"$ref":"#/components/schemas/V1OutsideSpender"}}},"required":["summary","top_spenders"]},"V1OutsideSpendingResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1OutsideSpendingData"},"meta":{"$ref":"#/components/schemas/V1ElectionsMeta"}},"required":["data","meta"]},"V1OutsideSpendingTarget":{"type":"object","properties":{"candidate_name":{"type":["string","null"]},"candidate_id":{"type":"string"},"party":{"type":["string","null"]},"office":{"type":["string","null"]},"state":{"type":["string","null"]},"total_outside_spending":{"type":"number"},"support_spending":{"type":["number","null"]},"oppose_spending":{"type":["number","null"]},"num_spenders":{"type":"number"}},"required":["candidate_name","candidate_id","party","office","state","total_outside_spending","support_spending","oppose_spending","num_spenders"]},"V1OutsideSpendingTargetsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1OutsideSpendingTarget"}},"meta":{"$ref":"#/components/schemas/V1ElectionsMeta"}},"required":["data","meta"]},"V1DisbursementRow":{"type":"object","properties":{"sub_id":{"type":"string","description":"FEC sub_id — unique transaction identifier"},"cycle":{"type":["number","null"]},"cmte_id":{"type":["string","null"]},"cmte_nm":{"type":["string","null"]},"committee_entity_id":{"type":["string","null"]},"recipient_name":{"type":["string","null"]},"recipient_city":{"type":["string","null"]},"recipient_state":{"type":["string","null"]},"recipient_zip":{"type":["string","null"]},"disbursement_date":{"type":["string","null"]},"disbursement_amt":{"type":["number","null"]},"disbursement_purpose":{"type":["string","null"]},"transaction_type":{"type":["string","null"]},"entity_type":{"type":["string","null"]}},"required":["sub_id","cycle","cmte_id","cmte_nm","committee_entity_id","recipient_name","recipient_city","recipient_state","recipient_zip","disbursement_date","disbursement_amt","disbursement_purpose","transaction_type","entity_type"]},"V1FilingsMeta":{"type":"object","properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"cycle":{"type":"number"},"source":{"type":"string"}},"required":["source"]},"V1DisbursementsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1DisbursementRow"}},"meta":{"$ref":"#/components/schemas/V1FilingsMeta"}},"required":["data","meta"]},"V1FilingsError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"V1DisbursementDetail":{"allOf":[{"$ref":"#/components/schemas/V1DisbursementRow"},{"type":"object","properties":{"memo_text":{"type":["string","null"]}},"required":["memo_text"]}]},"V1DisbursementDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DisbursementDetail"},"meta":{"$ref":"#/components/schemas/V1FilingsMeta"}},"required":["data","meta"]},"V1IndependentExpenditureRow":{"type":"object","properties":{"sub_id":{"type":"string","description":"FEC sub_id — unique transaction identifier"},"cycle":{"type":["number","null"]},"spender_cmte_id":{"type":["string","null"]},"cmte_id":{"type":["string","null"],"description":"Alias for spender_cmte_id (backwards compatibility)"},"cmte_nm":{"type":["string","null"]},"spender_entity_id":{"type":["string","null"]},"target_entity_id":{"type":["string","null"]},"target_candidate_id":{"type":["string","null"],"description":"FEC candidate ID being supported or opposed"},"target_candidate_name":{"type":["string","null"]},"support_oppose":{"type":["string","null"],"description":"\"S\" support, \"O\" oppose"},"expenditure_amt":{"type":["number","null"]},"expenditure_date":{"type":["string","null"]},"purpose":{"type":["string","null"]},"payee_name":{"type":["string","null"]},"payee_state":{"type":["string","null"]},"election_type":{"type":["string","null"]},"fec_election_year":{"type":["number","null"]}},"required":["sub_id","cycle","spender_cmte_id","cmte_id","cmte_nm","spender_entity_id","target_entity_id","target_candidate_id","target_candidate_name","support_oppose","expenditure_amt","expenditure_date","purpose","payee_name","payee_state","election_type","fec_election_year"]},"V1IndependentExpendituresResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1IndependentExpenditureRow"}},"meta":{"$ref":"#/components/schemas/V1FilingsMeta"}},"required":["data","meta"]},"V1IndependentExpenditureDetail":{"type":"object","properties":{"sub_id":{"type":"string","description":"FEC sub_id — unique transaction identifier"},"cycle":{"type":["number","null"]},"spender_cmte_id":{"type":["string","null"]},"cmte_id":{"type":["string","null"],"description":"Alias for spender_cmte_id (backwards compatibility)"},"cmte_nm":{"type":["string","null"]},"spender_entity_id":{"type":["string","null"]},"target_entity_id":{"type":["string","null"]},"target_candidate_id":{"type":["string","null"],"description":"FEC candidate ID being supported or opposed"},"target_candidate_name":{"type":["string","null"]},"support_oppose":{"type":["string","null"],"description":"\"S\" support, \"O\" oppose"},"expenditure_amt":{"type":["number","null"]},"expenditure_date":{"type":["string","null"]},"purpose":{"type":["string","null"]},"payee_name":{"type":["string","null"]},"payee_state":{"type":["string","null"]},"election_type":{"type":["string","null"]},"fec_election_year":{"type":["number","null"]}},"required":["sub_id","cycle","spender_cmte_id","cmte_id","cmte_nm","spender_entity_id","target_entity_id","target_candidate_id","target_candidate_name","support_oppose","expenditure_amt","expenditure_date","purpose","payee_name","payee_state","election_type","fec_election_year"]},"V1IndependentExpenditureDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1IndependentExpenditureDetail"},"meta":{"$ref":"#/components/schemas/V1FilingsMeta"}},"required":["data","meta"]},"V1LoanRow":{"type":"object","properties":{"sub_id":{"type":"string"},"cycle":{"type":["number","null"]},"committee_entity_id":{"type":["string","null"]},"cmte_id":{"type":["string","null"]},"cmte_nm":{"type":["string","null"]},"lender_name":{"type":["string","null"]},"lender_entity_id":{"type":["string","null"]},"loan_amount":{"type":["number","null"]},"loan_balance":{"type":["number","null"]},"loan_date":{"type":["string","null"]},"loan_due_date":{"type":["string","null"]},"interest_rate":{"type":["string","null"]},"is_personal_funds":{"type":["boolean","null"]},"is_secured":{"type":["boolean","null"]},"memo_text":{"type":["string","null"]}},"required":["sub_id","cycle","committee_entity_id","cmte_id","cmte_nm","lender_name","lender_entity_id","loan_amount","loan_balance","loan_date","loan_due_date","interest_rate","is_personal_funds","is_secured","memo_text"]},"V1LoansResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1LoanRow"}},"meta":{"$ref":"#/components/schemas/V1FilingsMeta"}},"required":["data","meta"]},"V1DebtRow":{"type":"object","properties":{"sub_id":{"type":"string"},"cycle":{"type":["number","null"]},"committee_entity_id":{"type":["string","null"]},"cmte_id":{"type":["string","null"]},"cmte_nm":{"type":["string","null"]},"creditor_name":{"type":["string","null"]},"creditor_entity_id":{"type":["string","null"]},"debt_amount":{"type":["number","null"]},"outstanding_balance":{"type":["number","null"]},"incurred_date":{"type":["string","null"]},"purpose":{"type":["string","null"]},"memo_text":{"type":["string","null"]}},"required":["sub_id","cycle","committee_entity_id","cmte_id","cmte_nm","creditor_name","creditor_entity_id","debt_amount","outstanding_balance","incurred_date","purpose","memo_text"]},"V1DebtsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1DebtRow"}},"meta":{"$ref":"#/components/schemas/V1FilingsMeta"}},"required":["data","meta"]},"V1VoteRow":{"type":"object","properties":{"vote_id":{"type":"number","description":"Internal numeric vote identifier"},"bill_id":{"type":["string","null"],"description":"Associated bill (TYPE-CONGRESS-NUMBER), if any"},"chamber":{"type":["string","null"]},"congress":{"type":["number","null"]},"session":{"type":["number","null"]},"roll_call_number":{"type":["number","null"]},"vote_date":{"type":["string","null"]},"vote_question":{"type":["string","null"]},"vote_result":{"type":["string","null"]},"yes_total":{"type":["number","null"]},"no_total":{"type":["number","null"]},"present_total":{"type":["number","null"]},"not_voting_total":{"type":["number","null"]},"bill_title":{"type":["string","null"]}},"required":["vote_id","bill_id","chamber","congress","session","roll_call_number","vote_date","vote_question","vote_result","yes_total","no_total","present_total","not_voting_total","bill_title"]},"V1VotesMeta":{"type":"object","properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"source":{"type":"string"}},"required":["source"]},"V1VotesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1VoteRow"}},"meta":{"$ref":"#/components/schemas/V1VotesMeta"}},"required":["data","meta"]},"V1VotesError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"V1VoteStats":{"type":"object","properties":{"vote_count":{"type":"number"},"legislator_vote_count":{"type":"number"},"congress_count":{"type":"number"},"earliest_congress":{"type":["number","null"]},"latest_congress":{"type":["number","null"]},"earliest_date":{"type":["string","null"]},"latest_date":{"type":["string","null"]},"by_chamber":{"type":"array","items":{"type":"object","properties":{"chamber":{"type":["string","null"]},"vote_count":{"type":"number"}},"required":["chamber","vote_count"]}},"by_result":{"type":"array","items":{"type":"object","properties":{"vote_result":{"type":"string"},"vote_count":{"type":"number"}},"required":["vote_result","vote_count"]}}},"required":["vote_count","legislator_vote_count","congress_count","earliest_congress","latest_congress","earliest_date","latest_date","by_chamber","by_result"]},"V1VoteStatsResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1VoteStats"},"meta":{"$ref":"#/components/schemas/V1VotesMeta"}},"required":["data","meta"]},"V1VoteLegislatorPosition":{"type":"object","properties":{"bioguide_id":{"type":"string"},"legislator_entity_id":{"type":["string","null"]},"vote_position":{"type":["string","null"],"description":"Yea / Nay / Present / Not Voting"},"full_name":{"type":["string","null"]},"party":{"type":["string","null"]},"state":{"type":["string","null"]},"chamber":{"type":["string","null"]}},"required":["bioguide_id","legislator_entity_id","vote_position","full_name","party","state","chamber"]},"V1VoteDetail":{"allOf":[{"$ref":"#/components/schemas/V1VoteRow"},{"type":"object","properties":{"bill_policy_area":{"type":["string","null"]},"positions":{"type":"array","items":{"$ref":"#/components/schemas/V1VoteLegislatorPosition"}}},"required":["bill_policy_area","positions"]}]},"V1VoteDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1VoteDetail"},"meta":{"$ref":"#/components/schemas/V1VotesMeta"}},"required":["data","meta"]},"V1SecStats":{"type":"object","properties":{"company_count":{"type":"number"},"filing_count":{"type":"number"},"insider_transaction_count":{"type":"number"},"form_type_count":{"type":"number"},"earliest_filing":{"type":["string","null"]},"latest_filing":{"type":["string","null"]}},"required":["company_count","filing_count","insider_transaction_count","form_type_count","earliest_filing","latest_filing"]},"V1SecMeta":{"type":"object","properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"source":{"type":"string"}},"required":["source"]},"V1SecStatsResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1SecStats"},"meta":{"$ref":"#/components/schemas/V1SecMeta"}},"required":["data","meta"]},"V1SecError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"V1SecCompanyRow":{"type":"object","properties":{"cik":{"type":"string"},"company_name":{"type":["string","null"]},"ticker_symbol":{"type":["string","null"]},"sic_code":{"type":["string","null"]},"sic_description":{"type":["string","null"]},"state_of_incorporation":{"type":["string","null"]},"entity_id":{"type":["string","null"]},"filing_count":{"type":["number","null"]}},"required":["cik","company_name","ticker_symbol","sic_code","sic_description","state_of_incorporation","entity_id","filing_count"]},"V1SecCompaniesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SecCompanyRow"}},"meta":{"$ref":"#/components/schemas/V1SecMeta"}},"required":["data","meta"]},"V1SecCompanyDetail":{"type":"object","properties":{"cik":{"type":"string"},"company_name":{"type":["string","null"]},"ticker_symbol":{"type":["string","null"]},"sic_code":{"type":["string","null"]},"sic_description":{"type":["string","null"]},"state_of_incorporation":{"type":["string","null"]},"fiscal_year_end":{"type":["string","null"]},"entity_id":{"type":["string","null"]},"filing_counts":{"type":"array","items":{"type":"object","properties":{"form_type":{"type":"string"},"count":{"type":"number"}},"required":["form_type","count"]}},"insider_stats":{"type":"array","items":{"type":"object","properties":{"insider_entity_id":{"type":["string","null"]},"transaction_count":{"type":"number"},"total_value":{"type":["number","null"]},"last_transaction_date":{"type":["string","null"]}},"required":["insider_entity_id","transaction_count","total_value","last_transaction_date"]}}},"required":["cik","company_name","ticker_symbol","sic_code","sic_description","state_of_incorporation","fiscal_year_end","entity_id","filing_counts","insider_stats"]},"V1SecCompanyDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1SecCompanyDetail"},"meta":{"$ref":"#/components/schemas/V1SecMeta"}},"required":["data","meta"]},"V1SecFilingRow":{"type":"object","properties":{"accession_number":{"type":"string"},"cik":{"type":["string","null"]},"company_name":{"type":["string","null"]},"ticker_symbol":{"type":["string","null"]},"company_entity_id":{"type":["string","null"]},"form_type":{"type":["string","null"]},"filing_date":{"type":["string","null"]},"primary_document":{"type":["string","null"]},"primary_doc_description":{"type":["string","null"]}},"required":["accession_number","cik","company_name","ticker_symbol","company_entity_id","form_type","filing_date","primary_document","primary_doc_description"]},"V1SecFilingsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SecFilingRow"}},"meta":{"$ref":"#/components/schemas/V1SecMeta"}},"required":["data","meta"]},"V1SecInsiderRow":{"type":"object","properties":{"insider_entity_id":{"type":["string","null"]},"company_entity_id":{"type":["string","null"]},"cik":{"type":["string","null"]},"company_name":{"type":["string","null"]},"ticker_symbol":{"type":["string","null"]},"transaction_count":{"type":"number"},"total_value":{"type":["number","null"]},"last_transaction_date":{"type":["string","null"]},"latest_shares_owned":{"type":["number","null"]}},"required":["insider_entity_id","company_entity_id","cik","company_name","ticker_symbol","transaction_count","total_value","last_transaction_date","latest_shares_owned"]},"V1SecInsidersResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SecInsiderRow"}},"meta":{"$ref":"#/components/schemas/V1SecMeta"}},"required":["data","meta"]},"V1SecTransactionRow":{"type":"object","properties":{"transaction_id":{"anyOf":[{"type":"string"},{"type":"number"}]},"accession_number":{"type":["string","null"]},"insider_entity_id":{"type":["string","null"]},"owner_name":{"type":["string","null"]},"is_director":{"type":["boolean","null"]},"is_officer":{"type":["boolean","null"]},"is_ten_percent_owner":{"type":["boolean","null"]},"officer_title":{"type":["string","null"]},"company_entity_id":{"type":["string","null"]},"cik":{"type":["string","null"]},"company_name":{"type":["string","null"]},"ticker_symbol":{"type":["string","null"]},"transaction_date":{"type":["string","null"]},"transaction_type":{"type":["string","null"]},"security_title":{"type":["string","null"]},"is_derivative":{"type":["boolean","null"]},"shares_amount":{"type":["number","null"]},"share_price":{"type":["number","null"]},"total_value":{"type":["number","null"]},"ownership_type":{"type":["string","null"]},"post_transaction_shares":{"type":["number","null"]}},"required":["transaction_id","accession_number","insider_entity_id","owner_name","is_director","is_officer","is_ten_percent_owner","officer_title","company_entity_id","cik","company_name","ticker_symbol","transaction_date","transaction_type","security_title","is_derivative","shares_amount","share_price","total_value","ownership_type","post_transaction_shares"]},"V1SecTransactionsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1SecTransactionRow"}},"meta":{"$ref":"#/components/schemas/V1SecMeta"}},"required":["data","meta"]},"V1LeiStats":{"type":"object","properties":{"relationship_count":{"type":"number"},"parent_count":{"type":"number"},"child_count":{"type":"number"},"relationship_type_count":{"type":"number"},"entity_count":{"type":"number"},"country_count":{"type":"number"},"active_count":{"type":"number"},"top_countries":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"cnt":{"type":"number"}},"required":["country","cnt"]}}},"required":["relationship_count","parent_count","child_count","relationship_type_count","entity_count","country_count","active_count","top_countries"]},"V1LeiMeta":{"type":"object","properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"parent_count":{"type":"number"},"child_count":{"type":"number"},"source":{"type":"string"}},"required":["source"]},"V1LeiStatsResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1LeiStats"},"meta":{"$ref":"#/components/schemas/V1LeiMeta"}},"required":["data","meta"]},"V1LeiError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"V1LeiEntityRow":{"type":"object","properties":{"entity_id":{"type":["string","null"]},"legal_name":{"type":["string","null"]},"lei":{"type":"string"},"registration_status":{"type":["string","null"]},"country":{"type":["string","null"]},"city":{"type":["string","null"]},"jurisdiction":{"type":["string","null"]},"entity_type":{"type":["string","null"]}},"required":["entity_id","legal_name","lei","registration_status","country","city","jurisdiction","entity_type"]},"V1LeiEntitiesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/V1LeiEntityRow"}},"meta":{"$ref":"#/components/schemas/V1LeiMeta"}},"required":["data","meta"]},"V1LeiRelationshipRow":{"type":"object","properties":{"relationship_id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"relationship_type":{"type":["string","null"]},"relationship_status":{"type":["string","null"]},"parent_lei":{"type":["string","null"]},"parent_name":{"type":["string","null"]},"parent_entity_id":{"type":["string","null"]},"parent_type":{"type":["string","null"]},"child_lei":{"type":["string","null"]},"child_name":{"type":["string","null"]},"child_entity_id":{"type":["string","null"]},"child_type":{"type":["string","null"]}},"required":["relationship_id","relationship_type","relationship_status"]},"V1LeiEntityDetail":{"type":"object","properties":{"entity":{"$ref":"#/components/schemas/V1LeiEntityRow"},"parents":{"type":"array","items":{"$ref":"#/components/schemas/V1LeiRelationshipRow"}},"children":{"type":"array","items":{"$ref":"#/components/schemas/V1LeiRelationshipRow"}}},"required":["entity","parents","children"]},"V1LeiEntityDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1LeiEntityDetail"},"meta":{"$ref":"#/components/schemas/V1LeiMeta"}},"required":["data","meta"]}},"parameters":{},"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication. Get yours at poliscope.org/developers."}}},"paths":{"/v1/stats":{"get":{"summary":"Platform statistics","description":"Aggregate counts across all Poliscope data sources: contributions (252M records), lobbying filings, government contracts (47M), entities, congressional data (candidates, committees, legislators, bills, votes), and SEC filings. Use to understand data coverage before diving into specific endpoints.","tags":["Platform"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1StatsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/search":{"get":{"summary":"Universal search","description":"Cross-source search across 8 result categories: politicians, companies, legislators, lobbying clients, donors, bills, appointees (executive branch filers), and gift_travel (congressional disclosures). Use as a starting point when you don't know the entity type or ID. Filter by types param (comma-separated: \"politician,company,legislator,lobbyist,donor,bill,appointee,gift_travel\"). Each result includes an ID for follow-up with the type-specific detail endpoint. For name-to-entity_id resolution, prefer resolve_entity instead.","tags":["Search"],"parameters":[{"schema":{"type":"string","minLength":2,"description":"Search query (min 2 chars)"},"required":true,"name":"q","in":"query"},{"schema":{"type":"string","description":"Comma-separated types: politician,company,legislator,lobbyist,donor,bill,appointee,gift_travel"},"required":false,"name":"types","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Max results per type"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SearchResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/politicians":{"get":{"summary":"Browse candidates","description":"Find FEC candidates by name, state, party, office, or election cycle. Returns fundraising totals per candidate, deduplicated by entity. Sorted by total_raised descending. Each result includes entity_id for cross-referencing. Use get_politician with the candidate ID for full profile with top donors and industries.","tags":["Politicians"],"parameters":[{"schema":{"type":"string","description":"Name search (e.g. \"warren\", \"trump\")"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","maxLength":2,"description":"US state abbreviation (e.g. \"CA\", \"TX\", \"NY\")"},"required":false,"name":"state","in":"query"},{"schema":{"type":"string","description":"Party: \"DEM\" (Democrat), \"REP\" (Republican), \"LIB\", \"IND\""},"required":false,"name":"party","in":"query"},{"schema":{"type":"string","description":"Office: \"H\" (House), \"S\" (Senate), \"P\" (President)"},"required":false,"name":"office","in":"query"},{"schema":{"type":["integer","null"],"description":"Election cycle (even years 2008-2026, e.g. 2024)","example":2024},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results (default 50, max 100)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1PoliticianListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/politicians/{id}":{"get":{"summary":"Politician profile","description":"Full FEC candidate profile. Includes per-cycle fundraising, top 500 contributors (with entity_ids), industry breakdown, committee list, and campaign history across all candidate IDs. Pass FEC Candidate ID (e.g. \"P80001571\" for Trump, \"P00009423\" for Biden). Returns entity_id and bioguide_id for cross-referencing. Related: check_relationship (connections), get_trades_by_politician (stock trades), get_legislator (congressional detail via bioguide_id), search_donors (individual contributions).","tags":["Politicians"],"parameters":[{"schema":{"type":"string","description":"FEC Candidate ID (e.g. P80001571)","example":"P80001571"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1PoliticianDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/legislators":{"get":{"summary":"Browse members of Congress","description":"Search current and historical members of Congress by name, chamber, party, or state. Defaults to current members (set current=\"false\" for historical). Sorted by total_raised descending. Returns bioguide_id for use with get_legislator, get_legislator_votes, and get_trades_by_politician.","tags":["Politicians"],"parameters":[{"schema":{"type":"string","description":"Name search (e.g. \"pelosi\", \"mcconnell\")"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"\"house\" or \"senate\""},"required":false,"name":"chamber","in":"query"},{"schema":{"type":"string","description":"Party: \"DEM\", \"REP\", \"IND\""},"required":false,"name":"party","in":"query"},{"schema":{"type":"string","maxLength":2,"description":"US state abbreviation (e.g. \"CA\", \"TX\")"},"required":false,"name":"state","in":"query"},{"schema":{"type":"string","enum":["true","false"],"description":"Filter to current members only. Defaults to \"true\" — set to \"false\" to include historical members"},"required":false,"name":"current","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results (default 50, max 100)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LegislatorListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/legislators/{bioguideId}":{"get":{"summary":"Legislator profile","description":"Full congressional member profile. Includes fundraising (top donors, industries, per-cycle totals), recent sponsored/cosponsored bills, voting summary, contact info, term history, and photo URL. Pass Bioguide ID (e.g. \"W000817\" for Warren, \"P000197\" for Pelosi). Returns fec_candidate_id for linking to get_politician and entity_id for check_relationship. Related: get_legislator_votes (voting record), get_trades_by_politician (stock trades), list_bills (legislation).","tags":["Politicians"],"parameters":[{"schema":{"type":"string","description":"Bioguide ID (e.g. \"W000817\" for Warren, \"P000197\" for Pelosi)"},"required":true,"name":"bioguideId","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LegislatorDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/legislators/{bioguideId}/votes":{"get":{"summary":"Legislator voting record","description":"Paginated voting record for a specific member of Congress. Each row includes the bill, vote question, result, and the legislator's position (Yea/Nay/Present/Not Voting). Filter by congress number. Use get_bill_votes for the reverse view (all legislators' votes on a specific bill).","tags":["Politicians"],"parameters":[{"schema":{"type":"string","description":"Bioguide ID (e.g. \"W000817\" for Warren)","example":"P000197"},"required":true,"name":"bioguideId","in":"path"},{"schema":{"type":["integer","null"],"description":"Filter by congress number (e.g. 118 for 2023-2024)"},"required":false,"name":"congress","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50, max 200)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LegislatorVotesResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/donors":{"get":{"summary":"Top donors","description":"Browse top campaign donors ranked by total contributions. Filter by donor type (individual/organization/committee), state, or election cycle. Returns entity_id for each donor. Use get_donor for full profile with recipient breakdown, or get_donor_coworkers to find bundling networks at the same employer.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"Name search (e.g. \"koch\", \"soros\")"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"Donor type: \"individual\", \"organization\", or \"committee\""},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","maxLength":2,"description":"US state abbreviation (e.g. \"NY\", \"CA\")"},"required":false,"name":"state","in":"query"},{"schema":{"type":["integer","null"],"description":"Election cycle (even years 2008-2026)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results (default 50, max 100)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DonorListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/committees":{"get":{"summary":"Browse committees","description":"Search FEC political committees — PACs, Super PACs, party committees, candidate committees, and JFCs. Filter by name, type, or party. Sorted by total_raised descending. Each result includes entity_id and committee_id. Use get_committee for full profile with top donors, candidate recipients, and party split by cycle.","tags":["Politicians"],"parameters":[{"schema":{"type":"string","description":"Name search"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"Committee type code"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","description":"Party affiliation"},"required":false,"name":"party","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CommitteeListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/committees/{cmteId}":{"get":{"summary":"Committee profile","description":"Full FEC committee profile. Includes top 500 donors (with entity_ids), candidate recipients, fundraising by cycle, and party split. Pass FEC Committee ID (e.g. \"C00431445\" for ActBlue). Use to investigate who funds a PAC and which candidates it supports. Related: get_politician (candidate receiving funds), check_relationship (entity connections).","tags":["Politicians"],"parameters":[{"schema":{"type":"string","description":"FEC Committee ID","example":"C00431445"},"required":true,"name":"cmteId","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CommitteeDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/lobbying/clients":{"get":{"summary":"Top lobbying clients","description":"Companies and organizations that hire lobbyists, ranked by total spending. Filter by name or filing year. Returns entity_id for cross-referencing with get_company and check_relationship. Use get_lobbying_client for full profile with spending history, issue areas, and hired firms. For topic-based lobbying search, use lobbying_by_topic instead.","tags":["Lobbying"],"parameters":[{"schema":{"type":"string","description":"Name search"},"required":false,"name":"q","in":"query"},{"schema":{"type":["integer","null"],"description":"Filter by filing year"},"required":false,"name":"year","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LobbyingClientListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/lobbying/firms":{"get":{"summary":"Top lobbying firms","description":"Registered lobbying firms (K Street firms, law firms with lobbying practices) ranked by total revenue. Filter by name or year. Returns entity_id for cross-referencing. Use get_lobbying_firm for full profile with client list, revenue history, and issue areas.","tags":["Lobbying"],"parameters":[{"schema":{"type":"string","description":"Name search"},"required":false,"name":"q","in":"query"},{"schema":{"type":["integer","null"],"description":"Filter by filing year"},"required":false,"name":"year","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LobbyingFirmListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/bills":{"get":{"summary":"Browse bills","description":"Search and filter congressional legislation. Supports full-text search, congress number (e.g. 118), policy area, sponsor party/state, bill type (HR/S/HJRES), date range, became_law filter, and subject search. Defaults to 118th Congress. Returns bill IDs (format: TYPE-CONGRESS-NUMBER, e.g. \"HR-118-1234\"). Use get_bill for full detail, or search_bills_semantic for topic-based search using AI embeddings.","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":"string","description":"Full-text search"},"required":false,"name":"q","in":"query"},{"schema":{"type":["integer","null"],"description":"Congress number (e.g. 118)"},"required":false,"name":"congress","in":"query"},{"schema":{"type":"string","description":"Filter by policy area"},"required":false,"name":"policy_area","in":"query"},{"schema":{"type":"string","enum":["true","false"],"description":"Filter to bills that became law"},"required":false,"name":"became_law","in":"query"},{"schema":{"type":"string","description":"Bill status filter"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","description":"Sponsor party (e.g. DEM, REP)"},"required":false,"name":"sponsor_party","in":"query"},{"schema":{"type":"string","maxLength":2,"description":"Sponsor state abbreviation"},"required":false,"name":"sponsor_state","in":"query"},{"schema":{"type":"string","description":"Legislative subject (ILIKE match)"},"required":false,"name":"subject","in":"query"},{"schema":{"type":"string","description":"Bill type (e.g. HR, S, HJRES)"},"required":false,"name":"bill_type","in":"query"},{"schema":{"type":"string","description":"Introduced date from (YYYY-MM-DD)"},"required":false,"name":"date_from","in":"query"},{"schema":{"type":"string","description":"Introduced date to (YYYY-MM-DD)"},"required":false,"name":"date_to","in":"query"},{"schema":{"type":"string","enum":["true","false"],"description":"Only bills with roll call votes"},"required":false,"name":"has_votes","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1BillListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/bills/{billId}":{"get":{"summary":"Bill detail","description":"Comprehensive bill detail. Includes sponsors (with bioguide_id and fec_candidate_id for cross-linking), legislative actions timeline, text versions (PDF/XML/TXT links), committee referrals, related bills, subjects, similar bills (via embeddings), and vote summary with party breakdown. Pass bill ID format TYPE-CONGRESS-NUMBER (e.g. \"HR-118-1234\"). Related: get_bill_lobbying (who lobbied on this), get_bill_sponsor_funding (who funds the sponsor), get_bill_votes (individual legislator positions), get_bill_actions (full timeline).","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":"string","description":"Bill ID (e.g. HR-118-1234)","example":"HR-118-1234"},"required":true,"name":"billId","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1BillDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/bills/{billId}/votes":{"get":{"summary":"Bill votes with legislator positions","description":"Full roll call votes for a bill, including every legislator's position (Yea/Nay/Present/Not Voting) with party and state. Paginated by roll call. Use to analyze party-line votes and bipartisan support. For a specific legislator's voting record across all bills, use get_legislator_votes instead.","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":"string","description":"Bill ID (e.g. HR-118-1234)","example":"HR-118-1234"},"required":true,"name":"billId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Max roll calls (default 10, max 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1BillVotesResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/contracts/recipients":{"get":{"summary":"Top contract recipients","description":"Top federal contract recipients ranked by total awarded amount, from USAspending.gov (47M+ contracts). Filter by name or state. Returns entity_id for cross-referencing with get_company. Use get_contract_dependency to analyze a company's concentration on specific agencies, or search_contracts for award-level detail.","tags":["Government Contracts"],"parameters":[{"schema":{"type":"string","description":"Name search"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","maxLength":2,"description":"US state abbreviation"},"required":false,"name":"state","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ContractRecipientListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/contracts/agencies":{"get":{"summary":"Top awarding agencies","description":"Federal agencies ranked by total contract obligations. Returns entity_id when available. Use get_contract_agency for full agency profile with top recipients, spending by fiscal year, and NAICS industry breakdown.","tags":["Government Contracts"],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Max results"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ContractAgencyListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/companies":{"get":{"summary":"Search companies","description":"Search for organizations with cross-source financial summaries aggregating campaign contributions, lobbying spending, government contracts, and SEC data. Returns entity_id, ticker, LEI, and influence_score. Use get_company for full profile. For lobbying-specific search, use list_lobbying_clients. For contract-specific search, use list_contract_recipients.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","minLength":2,"description":"Search query (min 2 chars)"},"required":true,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CompanyListResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/companies/{identifier}":{"get":{"summary":"Unified company profile","description":"Cross-source company profile. Aggregates campaign contributions (top recipients), lobbying (spending by year, top issues, hired firms), government contracts (by agency), SEC insider transactions, and source IDs (CIK, UEI, LEI). Accepts entity UUID, ticker symbol (e.g. \"AMZN\"), CIK, UEI, or URL-encoded name. Related: get_company_hierarchy (GLEIF corporate tree), get_lobbying_client (lobbying detail), search_contracts (contract awards), check_relationship (connections to politicians).","tags":["Corporate"],"parameters":[{"schema":{"type":"string","description":"Entity UUID, ticker (e.g. AMZN), CIK, UEI, or company name","example":"AMZN"},"required":true,"name":"identifier","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CompanyDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/donors/search":{"get":{"summary":"Donor lookup","description":"Search individual FEC contribution records (252M+ rows) by donor name, employer, ZIP code, state, cycle, or recipient. Returns individual transaction rows with amounts, dates, and recipient details. At least one filter required. Use to investigate specific donations — e.g., \"who at Goldman Sachs donated to candidate X?\" For aggregated donor profiles, use get_donor instead. For employer-level aggregates, use get_donors_by_employer.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"Donor name search (ILIKE)"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"Employer name search (ILIKE)"},"required":false,"name":"employer","in":"query"},{"schema":{"type":"string","description":"5-digit ZIP code prefix"},"required":false,"name":"zip","in":"query"},{"schema":{"type":"string","maxLength":2,"description":"US state abbreviation"},"required":false,"name":"state","in":"query"},{"schema":{"type":["integer","null"],"description":"Election cycle year"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"string","description":"Recipient committee name search (ILIKE)"},"required":false,"name":"recipient","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DonorSearchResponse"}}}},"400":{"description":"Bad request — provide at least one filter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/donors/{id}":{"get":{"summary":"Donor profile","description":"Individual donor profile with total contributions, top recipients (with entity_ids), and giving history by election cycle. Pass entity UUID. Returns influence_score and activity date range. Related: get_donor_coworkers (find bundling at same employer), check_relationship (verify specific donor-recipient connections), search_donors (search raw contribution records).","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"Entity UUID","example":"a1b2c3d4-..."},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DonorDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/lobbying/stats":{"get":{"summary":"Lobbying statistics","description":"Platform-level lobbying statistics: total clients, firms, filings, income, and expenses with year range. Use to understand overall lobbying data coverage before querying specific clients or firms.","tags":["Lobbying"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LobbyingStatsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/lobbying/clients/{name}":{"get":{"summary":"Lobbying client profile","description":"Detailed lobbying client profile. Includes annual spending history, top LDA issue codes, and hired lobbying firms with amounts paid. Accepts URL-encoded client name or entity UUID. Filter by filing year. Related: get_company (cross-source corporate profile), lobbying_by_topic (find clients lobbying on a specific topic), list_lobbying_issues (reference of all issue codes).","tags":["Lobbying"],"parameters":[{"schema":{"type":"string","description":"Client name (URL-encoded) or entity UUID"},"required":true,"name":"name","in":"path"},{"schema":{"type":["integer","null"],"description":"Filter by filing year"},"required":false,"name":"year","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LobbyingClientDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/lobbying/firms/{name}":{"get":{"summary":"Lobbying firm profile","description":"Detailed lobbying firm profile. Includes annual revenue/expenses, top clients (with entity_ids), and top issue areas. Accepts URL-encoded firm name or entity UUID. Filter by year. Use to investigate which firms represent which corporate interests.","tags":["Lobbying"],"parameters":[{"schema":{"type":"string","description":"Firm name (URL-encoded) or entity UUID"},"required":true,"name":"name","in":"path"},{"schema":{"type":["integer","null"],"description":"Filter by filing year"},"required":false,"name":"year","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LobbyingFirmDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/trades":{"get":{"summary":"Congressional stock trades","description":"Browse STOCK Act periodic transaction reports filed by members of Congress. Filter by chamber (house/senate), stock ticker (e.g. \"AAPL\"), filer name, transaction type (purchase/sale_full/sale_partial/exchange), and date range. Use to detect potential conflicts of interest. Related: get_trades_by_politician (all trades for one member), get_trades_by_ticker (all congressional trades in one stock), get_trades_summary (most active traders and stocks).","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","enum":["senate","house"],"description":"Filter by chamber"},"required":false,"name":"chamber","in":"query"},{"schema":{"type":"string","description":"Filter by stock ticker (e.g. AAPL)"},"required":false,"name":"ticker","in":"query"},{"schema":{"type":"string","description":"Search filer name"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","enum":["purchase","sale_full","sale_partial","exchange"],"description":"Transaction type"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","description":"Start date (YYYY-MM-DD)"},"required":false,"name":"start_date","in":"query"},{"schema":{"type":"string","description":"End date (YYYY-MM-DD)"},"required":false,"name":"end_date","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results (default 50, max 100)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset for pagination"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1TradesResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/trades/by-politician/{bioguideId}":{"get":{"summary":"Trades by politician","description":"All STOCK Act trades for a specific member of Congress. Pass Bioguide ID (e.g. \"P000197\" for Pelosi). Returns ticker, asset name, transaction type, amount range, and filing URL. Use get_legislator to get the bioguide_id from a name search. Related: get_bill (check if member voted on bills related to stocks they traded).","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"Bioguide ID (e.g. P000197)"},"required":true,"name":"bioguideId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":100,"description":"Max results (default 100, max 200)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset for pagination"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1TradesByPoliticianResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/trades/by-ticker/{ticker}":{"get":{"summary":"Trades by ticker","description":"All congressional stock trades for a specific stock ticker symbol (e.g. \"AAPL\", \"NVDA\", \"MSFT\"). Use to see which members of Congress are buying or selling a particular stock. Returns filer name, party, transaction date, and amount range.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"Stock ticker symbol (e.g. AAPL, MSFT)"},"required":true,"name":"ticker","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results (default 50, max 100)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset for pagination"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1TradesByTickerResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/trades/summary":{"get":{"summary":"Trades summary stats","description":"Aggregate STOCK Act statistics: total trades/traders/tickers, most active traders (with bioguide_id, party, estimated volume), and most traded tickers (buy/sell counts). Use as an overview before drilling into specific politicians or tickers.","tags":["Campaign Finance"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1TradesSummaryResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/spending/vendors":{"get":{"summary":"Top political vendors","description":"Top political vendors (media firms, consultants, ad agencies) ranked by total disbursements received from political committees. Search by vendor name. Use get_spending_vendor for full profile with spending by cycle, top paying committees, and payment purposes.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"Vendor name search (ILIKE)"},"required":false,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset for pagination"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SpendingVendorListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/spending/vendors/{name}":{"get":{"summary":"Vendor detail","description":"Detailed political vendor profile. Includes spending by election cycle, top paying committees (with party and designation), and most common payment purposes. Pass URL-encoded vendor name. Filter by cycle. Use to trace where campaign money goes — which firms handle advertising, consulting, polling, etc.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"URL-encoded vendor name"},"required":true,"name":"name","in":"path"},{"schema":{"type":["integer","null"],"description":"Filter to specific election cycle"},"required":false,"name":"cycle","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SpendingVendorDetailResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/spending/summary":{"get":{"summary":"Spending summary","description":"Aggregate statistics across all political committee disbursements: total amount, number of disbursements, committees, and vendors. Includes top vendors and spending by election cycle. Use as an overview before drilling into specific vendors.","tags":["Campaign Finance"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SpendingSummaryResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/contracts/search":{"get":{"summary":"Search contracts","description":"Award-level search across 47.3M federal contracts from USAspending.gov. Filter by text search, agency name, fiscal year, NAICS code, state, amount range, or award type. At least one filter required. Returns individual contract awards with recipient, agency, amount, and description. Use get_contract for full award detail, or list_contract_recipients for company-level aggregates.","tags":["Government Contracts"],"parameters":[{"schema":{"type":"string","description":"Full-text search on award descriptions"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"Awarding agency name (ILIKE)"},"required":false,"name":"agency","in":"query"},{"schema":{"type":["integer","null"],"description":"Filter by fiscal year"},"required":false,"name":"fiscal_year","in":"query"},{"schema":{"type":"string","description":"NAICS industry code"},"required":false,"name":"naics","in":"query"},{"schema":{"type":"string","maxLength":2,"description":"Performance state abbreviation"},"required":false,"name":"state","in":"query"},{"schema":{"type":["number","null"],"description":"Minimum award amount"},"required":false,"name":"min_amount","in":"query"},{"schema":{"type":["number","null"],"description":"Maximum award amount"},"required":false,"name":"max_amount","in":"query"},{"schema":{"type":"string","description":"Award type filter"},"required":false,"name":"award_type","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset for pagination"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ContractSearchResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/contracts/agencies/{name}":{"get":{"summary":"Agency contract profile","description":"Federal agency contract profile. Includes top recipients (with entity_ids), spending by fiscal year, and top NAICS industry categories. Pass URL-encoded agency name. Use to investigate which companies receive the most from a specific agency.","tags":["Government Contracts"],"parameters":[{"schema":{"type":"string","description":"URL-encoded agency name"},"required":true,"name":"name","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ContractAgencyDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/contracts/{id}":{"get":{"summary":"Contract award detail","description":"Full details for a single federal contract award. Includes recipient (with entity_id), awarding and funding agencies, NAICS/PSC industry codes, performance location, dates, COVID-19 and infrastructure obligation flags. Pass the USAspending award ID.","tags":["Government Contracts"],"parameters":[{"schema":{"type":"string","description":"Award ID"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ContractAwardDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/lobbying/issues":{"get":{"summary":"LDA issue codes","description":"Reference list of all ~80 LDA general issue area codes with human-readable labels (e.g. \"TAX\" = \"Taxation/Internal Revenue Code\", \"DEF\" = \"Defense\"). Use to understand issue codes returned by get_lobbying_client and get_lobbying_firm. For topic-based lobbying search, use lobbying_by_topic which maps free-text topics to these codes automatically.","tags":["Lobbying"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LobbyingIssueListResponse"}}}}}}},"/v1/sec/search/semantic":{"get":{"summary":"Semantic search SEC filings","description":"Search SEC EDGAR filing sections using BGE-M3 vector embeddings for semantic similarity. Finds relevant disclosures even without exact keyword matches. Filter by form type (10-K, 8-K, 10-Q, etc.) and section type. Returns snippets with similarity scores, company entity_id, and accession numbers. Use get_sec_filing for full filing detail with parsed sections.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","minLength":1,"description":"Semantic search query"},"required":true,"name":"q","in":"query"},{"schema":{"type":"string","description":"Filter by form type (10-K, 8-K, 10-Q, etc.)"},"required":false,"name":"form_type","in":"query"},{"schema":{"type":"string","description":"Filter by section type"},"required":false,"name":"section_type","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"maximum":1,"default":0.3,"description":"Min cosine similarity"},"required":false,"name":"min_similarity","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecSearchResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/sec/filings/{accession}":{"get":{"summary":"SEC filing detail","description":"Full SEC EDGAR filing detail. Includes company info (with entity_id), parsed document sections (with previews and word counts), and similar filings ranked by embedding similarity. Pass SEC accession number. Use get_company for the company's full cross-source profile.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","description":"SEC accession number"},"required":true,"name":"accession","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecFilingDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/congressional-committees":{"get":{"summary":"Browse congressional committees","description":"List congressional committees (House, Senate, Joint) with bill referral counts and activity summaries. Filter by chamber or search by name. These are legislative committees (e.g. SSAS = Senate Armed Services), not FEC political committees — for PACs and fundraising committees, use list_committees instead.","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":"string","description":"Filter by chamber (house, senate)"},"required":false,"name":"chamber","in":"query"},{"schema":{"type":"string","description":"Search by committee name"},"required":false,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CongressionalCommitteeListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/congressional-committees/{code}":{"get":{"summary":"Congressional committee detail","description":"Congressional committee profile with recent referred bills, top policy areas, activity breakdown by type (referral, hearing, markup, etc.), and activity by year. Pass committee code (e.g. \"SSAS\" for Senate Armed Services, \"HSAP\" for House Appropriations).","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":"string","description":"Committee code (e.g., SSAS, HSAP)"},"required":true,"name":"code","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CongressionalCommitteeDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/pensions":{"get":{"summary":"List pension plans","description":"Browse public pension plans from the Public Plans Database (PPD, 254 plans). Filter by state, plan type, minimum assets, or maximum funded ratio (e.g. max_funded_ratio=0.6 for underfunded plans). Returns latest financials snapshot. Use get_pension for full financial history, get_pension_financials for time series, or get_pension_allocation for asset allocation trends.","tags":["Pensions"],"parameters":[{"schema":{"type":"string","description":"Search plan name"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"Filter by state (e.g., CA, NY)"},"required":false,"name":"state","in":"query"},{"schema":{"type":"string","description":"Filter by plan type"},"required":false,"name":"plan_type","in":"query"},{"schema":{"type":["number","null"],"description":"Minimum market assets"},"required":false,"name":"min_assets","in":"query"},{"schema":{"type":["number","null"],"description":"Maximum funded ratio (e.g., 0.6 for underfunded)"},"required":false,"name":"max_funded_ratio","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1PensionListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/pensions/summary":{"get":{"summary":"Pension aggregate statistics","description":"Aggregate pension statistics: total plans, states covered, assets by state, funded ratio by plan type, and most underfunded plans. Use as an overview before drilling into specific plans with get_pension.","tags":["Pensions"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1PensionSummaryResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/pensions/{id}":{"get":{"summary":"Pension plan detail","description":"Full pension plan profile with complete financial history (assets, liabilities, funded ratio, investment returns, membership) and asset allocation timeline (equity, fixed income, alternatives, etc.). Pass plan ID or PPD ID. For just financials or allocations separately, use get_pension_financials or get_pension_allocation.","tags":["Pensions"],"parameters":[{"schema":{"type":"string","description":"Plan ID or PPD ID"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1PensionDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/pensions/{id}/financials":{"get":{"summary":"Pension plan financials","description":"Annual financial time series for a pension plan: actuarial assets/liabilities, funded ratio, UAAL, market assets, contributions, benefits paid, 1/5/10-year investment returns, payroll, and membership counts. Pass plan ID or PPD ID.","tags":["Pensions"],"parameters":[{"schema":{"type":"string","description":"Plan ID or PPD ID"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1PensionFinancialsResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/pensions/{id}/allocation":{"get":{"summary":"Pension plan asset allocation","description":"Asset allocation history for a pension plan by fiscal year: equity, fixed income, real estate, alternatives, private equity, hedge funds, commodities, and cash percentages. Pass plan ID or PPD ID.","tags":["Pensions"],"parameters":[{"schema":{"type":"string","description":"Plan ID or PPD ID"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1PensionAllocationResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/nonprofits":{"get":{"summary":"List nonprofit organizations","description":"Browse politically relevant nonprofits — 501(c)(4), 501(c)(5), 501(c)(6), and 527 organizations from the IRS Business Master File (170K+ orgs). Filter by state, subsection code, minimum assets/income. Returns EIN for use with get_nonprofit, get_nonprofit_grants, and get_dark_money_source. For fuzzy name search, use search_nonprofits instead.","tags":["Nonprofits & Dark Money"],"parameters":[{"schema":{"type":"string","description":"Search organization name"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"Filter by state (e.g., DC, VA)"},"required":false,"name":"state","in":"query"},{"schema":{"type":"string","description":"Filter by subsection code (501c4, 501c5, 501c6, 527)"},"required":false,"name":"subsection","in":"query"},{"schema":{"type":["number","null"],"description":"Minimum asset amount"},"required":false,"name":"min_assets","in":"query"},{"schema":{"type":["number","null"],"description":"Minimum income amount"},"required":false,"name":"min_income","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1NonprofitListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/nonprofits/summary":{"get":{"summary":"Nonprofit aggregate statistics","description":"Aggregate nonprofit statistics: total organizations, assets/income by subsection code and state, entity linkage rate, and largest organizations by assets. Use as an overview before searching specific nonprofits.","tags":["Nonprofits & Dark Money"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1NonprofitSummaryResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/nonprofits/search":{"get":{"summary":"Search nonprofits","description":"Fuzzy search nonprofit organizations by name using trigram matching. Use when you have a name or partial name (e.g. \"Americans for Prosperity\", \"Heritage\"). Returns EIN for follow-up with get_nonprofit. For browsing with filters, use list_nonprofits instead.","tags":["Nonprofits & Dark Money"],"parameters":[{"schema":{"type":"string","description":"Search query (min 2 characters)"},"required":true,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":25,"default":15},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1NonprofitSearchResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/nonprofits/{ein}":{"get":{"summary":"Nonprofit detail","description":"Full nonprofit profile by EIN (9-digit Employer Identification Number). Includes IRS BMF data, 990 filings (revenue, expenses, net assets), grants paid (Schedule I — key for dark money tracing), and officers with compensation. Related: get_nonprofit_grants (paginated grant detail), get_nonprofit_officers (officer detail), get_dark_money_source (dark money traces from this nonprofit).","tags":["Nonprofits & Dark Money"],"parameters":[{"schema":{"type":"string","description":"Employer Identification Number (9 digits)"},"required":true,"name":"ein","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1NonprofitDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/nonprofits/{ein}/grants":{"get":{"summary":"Nonprofit grants paid","description":"Grants paid by a nonprofit (IRS 990 Schedule I). Critical for dark money tracing — shows where money flows to other organizations and political committees. Filter by tax year. Returns recipient names/EINs (with entity_ids when linked) and grant purposes. Use get_dark_money_source to see traced connections to political spending.","tags":["Nonprofits & Dark Money"],"parameters":[{"schema":{"type":"string","description":"Employer Identification Number"},"required":true,"name":"ein","in":"path"},{"schema":{"type":["number","null"],"description":"Filter by tax year"},"required":false,"name":"year","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1NonprofitGrantsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/nonprofits/{ein}/officers":{"get":{"summary":"Nonprofit officers and compensation","description":"Officers, directors, trustees, and key employees from IRS 990 Part VII. Includes reportable and other compensation, hours worked, and role flags. Returns person_entity_id when available for cross-referencing with other data sources (e.g. checking if an officer is also a campaign donor or lobbyist via check_relationship).","tags":["Nonprofits & Dark Money"],"parameters":[{"schema":{"type":"string","description":"Employer Identification Number"},"required":true,"name":"ein","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1NonprofitOfficersResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/search/resolve":{"get":{"summary":"Resolve entity name","description":"Resolves informal/abbreviated names to entity_ids. Handles aliases (e.g. \"AIPAC\" → American Israel Public Affairs Committee), abbreviations, and partial names. Uses trigram fuzzy matching on entity aliases and canonical names. Returns entity_id, entity_type, match source, and confidence score. Use this FIRST when you have a name but need an entity_id for other tools like check_relationship, get_politician, get_company, or get_donor.","tags":["Search"],"parameters":[{"schema":{"type":"string","minLength":2,"description":"Name to resolve (abbreviation, alias, or partial name)"},"required":true,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":20,"default":5,"description":"Max results"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ResolveResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/search/relationship":{"get":{"summary":"Check entity relationship","description":"Verify whether two entities have a financial relationship. Checks campaign contributions (with totals, counts, cycles), shared lobbying issue areas, and pre-computed relationship metrics (edge types, weights, date ranges). Pass two entity_ids (get these from resolve_entity or any detail endpoint). Returns has_relationship boolean and detailed evidence. Use to answer questions like \"Did company X donate to politician Y?\" or \"Are these two organizations connected?\"","tags":["Search"],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Source entity_id"},"required":true,"name":"from","in":"query"},{"schema":{"type":"string","format":"uuid","description":"Target entity_id"},"required":true,"name":"to","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1RelationshipResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/lobbying/by-topic":{"get":{"summary":"Lobbying activity by topic","description":"Find lobbying activity by topic. Maps free-text topics (e.g. \"Israel foreign policy\", \"defense spending\", \"healthcare reform\") to LDA issue codes and returns top spending clients and firms. Filter by year. Use when investigating lobbying around a specific policy area rather than a specific company. Related: list_lobbying_issues (full code reference), get_lobbying_client (client detail).","tags":["Lobbying"],"parameters":[{"schema":{"type":"string","minLength":2,"description":"Topic text (e.g. \"Israel foreign policy\", \"defense spending\")"},"required":true,"name":"topic","in":"query"},{"schema":{"type":["integer","null"],"description":"Filing year filter"},"required":false,"name":"year","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Max client results"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LobbyingByTopicResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/bills/search/semantic":{"get":{"summary":"Semantic bill search","description":"Search congressional bills using BGE-M3 vector embeddings for semantic similarity. Finds related legislation even without exact keyword matches — e.g., \"climate change\" finds bills about carbon emissions, renewable energy, etc. Filter by congress number and similarity threshold. Use list_bills for keyword/filter-based search instead. Returns bill IDs for follow-up with get_bill.","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":"string","description":"Search query text"},"required":true,"name":"q","in":"query"},{"schema":{"type":["integer","null"],"description":"Congress number filter"},"required":false,"name":"congress","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"maximum":1,"default":0.55,"description":"Minimum similarity threshold"},"required":false,"name":"min_similarity","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1BillSemanticResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/bills/{billId}/lobbying":{"get":{"summary":"Bill-related lobbying activity","description":"Find who lobbied on a specific bill. Maps the bill's policy area to LDA issue codes and returns lobbying registrations with client names, registrant firms, spending amounts, and filing years. Use to answer \"Who lobbied for/against this bill?\" Related: get_bill_sponsor_funding (who funds the sponsor), lobbying_by_topic (broader topic search).","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":"string","description":"Bill ID (e.g. HR-118-1234)"},"required":true,"name":"billId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"},{"schema":{"type":["integer","null"],"description":"Filing year filter"},"required":false,"name":"year","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1BillLobbyingResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/bills/{billId}/sponsor-funding":{"get":{"summary":"Bill sponsor campaign finance","description":"Campaign finance profile of the bill's primary sponsor. Returns the sponsor's top donors (with entity_ids), top industries, and fundraising totals. Use to investigate potential conflicts of interest — e.g., \"Is the sponsor funded by industries that would benefit from this bill?\" Related: get_bill_lobbying (who lobbied on this bill), get_politician (full sponsor profile).","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":"string","description":"Bill ID (e.g. HR-118-1234)"},"required":true,"name":"billId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Max donor results"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1BillSponsorFundingResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/bills/{billId}/actions":{"get":{"summary":"Bill legislative actions","description":"Full timeline of legislative actions for a bill: introductions, committee referrals, hearings, markups, floor votes, conference reports, presidential actions. Filter by chamber (House/Senate) or action type. Use to track a bill's progress through Congress.","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":"string","description":"Bill ID (e.g. HR-118-1234)"},"required":true,"name":"billId","in":"path"},{"schema":{"type":"string","description":"Filter by chamber: House, Senate"},"required":false,"name":"chamber","in":"query"},{"schema":{"type":"string","description":"Filter by action type"},"required":false,"name":"action_type","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1BillActionsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/donors/{id}/coworkers":{"get":{"summary":"Donor coworker bundling analysis","description":"Find people from the same employer contributing to the same political recipients — identifies potential bundling networks. Pass donor entity_id. Returns coworkers with their total contributions, number of recipients, and count of shared recipients. Filter by cycle and minimum amount. Use to investigate coordinated giving patterns at companies and law firms.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Donor entity_id"},"required":true,"name":"id","in":"path"},{"schema":{"type":["integer","null"],"description":"Election cycle year"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":["number","null"],"default":200,"description":"Minimum contribution threshold"},"required":false,"name":"min_amount","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Max results"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CoworkersResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/contracts/{entityId}/dependency":{"get":{"summary":"Government contract dependency analysis","description":"Analyze a company's dependency on government contracts. Returns top awarding agencies, concentration ratio (how much comes from one agency), annual award trends, and total contract value. Pass recipient entity_id. Use to assess government revenue risk and identify companies heavily dependent on federal spending.","tags":["Government Contracts"],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Recipient entity_id"},"required":true,"name":"entityId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":20,"default":10,"description":"Max agency results"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ContractDependencyResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/dark-money":{"get":{"summary":"Browse dark money traces","description":"Browse dark money traces linking nonprofit donors to political committee spending (7,800+ traces, $6.5B tracked). Filter by source EIN, destination committee, tax year, minimum amount, match confidence, or match method. Use to investigate how money flows from nonprofits (501c4s) to political committees. Related: get_dark_money_source (detail by nonprofit), get_dark_money_destination (detail by committee), search_dark_money (fuzzy name search).","tags":["Nonprofits & Dark Money"],"parameters":[{"schema":{"type":"string","description":"Text search"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"Source nonprofit EIN"},"required":false,"name":"source_ein","in":"query"},{"schema":{"type":"string","description":"Destination committee ID or name"},"required":false,"name":"destination","in":"query"},{"schema":{"type":["integer","null"],"description":"Tax year filter"},"required":false,"name":"year","in":"query"},{"schema":{"type":["number","null"],"description":"Minimum grant amount"},"required":false,"name":"min_amount","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"maximum":1,"default":0.6,"description":"Minimum match confidence"},"required":false,"name":"min_confidence","in":"query"},{"schema":{"type":"string","description":"Match method filter"},"required":false,"name":"method","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DarkMoneyListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/dark-money/summary":{"get":{"summary":"Dark money aggregate statistics","description":"Aggregate dark money statistics: total traces, total grant amounts, unique sources/destinations, by-year breakdown, top source nonprofits, and top destination committees. Use as an overview before investigating specific sources or destinations.","tags":["Nonprofits & Dark Money"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DarkMoneySummaryResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/dark-money/search":{"get":{"summary":"Search dark money traces","description":"Fuzzy search dark money traces by source nonprofit or destination committee name. Use when you have a name but not an EIN or committee ID. Returns trace summaries with amounts and confidence scores. Follow up with get_dark_money_source or get_dark_money_destination for full detail.","tags":["Nonprofits & Dark Money"],"parameters":[{"schema":{"type":"string","minLength":2,"description":"Search query (min 2 chars)"},"required":true,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":25,"default":15,"description":"Max results"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DarkMoneySearchResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/dark-money/source/{ein}":{"get":{"summary":"Dark money source detail","description":"Detail for a nonprofit as a source of dark money. Shows all traced grants to political committees, recipient breakdown with totals, and nonprofit info (entity_id, state). Pass the source nonprofit's EIN. Related: get_nonprofit (full 990 profile), get_nonprofit_grants (all grants, not just political).","tags":["Nonprofits & Dark Money"],"parameters":[{"schema":{"type":"string","description":"Source nonprofit EIN"},"required":true,"name":"ein","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DarkMoneySourceResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/dark-money/destination/{cmteId}":{"get":{"summary":"Dark money destination detail","description":"Detail for a political committee receiving dark money. Shows all traces from nonprofit sources, source breakdown with totals, and lists of candidates supported/opposed. Pass the destination committee ID. Related: get_committee (full FEC committee profile), get_outside_spending (independent expenditure detail).","tags":["Nonprofits & Dark Money"],"parameters":[{"schema":{"type":"string","description":"Destination committee ID"},"required":true,"name":"cmteId","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DarkMoneyDestinationResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/gifts":{"get":{"summary":"Congressional gift & travel filings","description":"Browse congressional gift and travel disclosures from the House Clerk and Senate Gift Rule Database (9,600+ records). Filter by chamber, type (gift/travel), year, or member name. Returns filing details with sponsor, value, and dates. Use get_gift for full filing detail.","tags":["Gifts & Travel"],"parameters":[{"schema":{"type":"string","description":"Search gift descriptions or member names"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","enum":["house","senate"],"description":"Filter by chamber: \"house\" or \"senate\""},"required":false,"name":"chamber","in":"query"},{"schema":{"type":"string","description":"Filing type (e.g. \"travel\", \"gift\")"},"required":false,"name":"type","in":"query"},{"schema":{"type":["integer","null"],"description":"Filing year (House 2018+, Senate 2022+)"},"required":false,"name":"year","in":"query"},{"schema":{"type":"string","description":"Member name search (ILIKE)"},"required":false,"name":"member","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results (default 50, max 100)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1GiftListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/gifts/{id}":{"get":{"summary":"Gift/travel filing detail","description":"Full detail for a single congressional gift or travel filing. Includes member name, sponsor/source, description, value, dates, and linked entity_id when available.","tags":["Gifts & Travel"],"parameters":[{"schema":{"type":"string","description":"Filing ID (numeric)"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1GiftDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/gifts/members":{"get":{"summary":"Gift/travel filings by member","description":"Members of Congress ranked by number of gift/travel filings. Filter by chamber and year. Use to find who receives the most gifts and travel sponsorships.","tags":["Gifts & Travel"],"parameters":[{"schema":{"type":"string","enum":["house","senate"],"description":"Filter by chamber"},"required":false,"name":"chamber","in":"query"},{"schema":{"type":["integer","null"],"description":"Filing year"},"required":false,"name":"year","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1GiftMembersResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/gifts/sponsors":{"get":{"summary":"Top gift/travel sponsors","description":"Organizations sponsoring the most congressional gifts and travel, ranked by filing count. Filter by chamber and year. Use to investigate which organizations are providing the most gifts and trips to members of Congress.","tags":["Gifts & Travel"],"parameters":[{"schema":{"type":"string","enum":["house","senate"],"description":"Filter by chamber"},"required":false,"name":"chamber","in":"query"},{"schema":{"type":["integer","null"],"description":"Filing year"},"required":false,"name":"year","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1GiftSponsorsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/gifts/summary":{"get":{"summary":"Gift/travel aggregate statistics","description":"Aggregate gift and travel statistics: total filings, total value, breakdown by chamber, year, and type. Use as an overview before searching specific filings or members.","tags":["Gifts & Travel"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1GiftSummaryResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/disclosures/appointees":{"get":{"summary":"Executive branch appointees","description":"Browse executive branch appointees who filed OGE 278e financial disclosures. Filter by name, agency, administration, or appointment type. Returns appointee IDs for use with get_appointee. Related: search_disclosures (search across all disclosure types).","tags":["Financial Disclosures"],"parameters":[{"schema":{"type":"string","description":"Search appointee name"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"Filter by agency name (ILIKE)"},"required":false,"name":"agency","in":"query"},{"schema":{"type":"string","description":"Filter by administration (e.g. \"Biden\", \"Trump\")"},"required":false,"name":"administration","in":"query"},{"schema":{"type":"string","description":"Filter by appointment type"},"required":false,"name":"appointment_type","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results (default 50, max 100)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1AppointeeListResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/disclosures/appointees/{id}":{"get":{"summary":"Appointee disclosure profile","description":"Full OGE 278e financial disclosure profile for an executive branch appointee. Includes assets, positions held, transactions, agreements, liabilities, and compensation history. Use to investigate potential conflicts of interest in government appointments.","tags":["Financial Disclosures"],"parameters":[{"schema":{"type":"string","description":"Appointee ID (numeric)"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1AppointeeDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/disclosures/filings/{id}":{"get":{"summary":"OGE filing detail","description":"Full OGE 278e filing detail with all disclosure sections: assets, positions, transactions, agreements, liabilities, and compensation. Pass the disclosure filing ID.","tags":["Financial Disclosures"],"parameters":[{"schema":{"type":"string","description":"Disclosure filing ID (numeric)"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DisclosureFilingResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/disclosures/search":{"get":{"summary":"Search financial disclosures","description":"Search across all OGE 278e disclosure data by keyword. Filter by type: \"assets\" (financial holdings), \"positions\" (outside positions held), \"transactions\" (financial transactions), \"compensation\" (non-government compensation), or \"all\". Use to find appointees with ties to specific companies or industries.","tags":["Financial Disclosures"],"parameters":[{"schema":{"type":"string","minLength":2,"description":"Search query (min 2 chars) — searches asset names, position descriptions, etc."},"required":true,"name":"q","in":"query"},{"schema":{"type":"string","enum":["assets","positions","transactions","compensation","all"],"description":"Disclosure type to search"},"required":false,"name":"type","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Max results (default 20, max 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DisclosureSearchResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/disclosures/summary":{"get":{"summary":"Disclosure aggregate statistics","description":"Aggregate OGE financial disclosure statistics: total appointees, filings, assets, positions, and transactions. Breakdown by agency and administration.","tags":["Financial Disclosures"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DisclosureSummaryResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/companies/{identifier}/hierarchy":{"get":{"summary":"Corporate hierarchy tree","description":"GLEIF corporate parent-child hierarchy for a company. Traverses Legal Entity Identifier (LEI) relationships up to parent companies and down to subsidiaries. Control depth (1-5, default 3) and direction (up/down/both). Use to understand corporate ownership structures and identify parent companies behind subsidiaries. Pass entity UUID, ticker, CIK, UEI, or company name.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","description":"Entity UUID, ticker (e.g. \"AMZN\"), CIK, UEI, or company name"},"required":true,"name":"identifier","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":5,"default":3,"description":"Max traversal depth (1-5, default 3)"},"required":false,"name":"depth","in":"query"},{"schema":{"type":"string","enum":["up","down","both"],"default":"both","description":"Traversal direction: \"up\" (parents), \"down\" (subsidiaries), \"both\""},"required":false,"name":"direction","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CompanyHierarchyResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/donors/by-employer":{"get":{"summary":"Aggregate employee contributions by employer","description":"Aggregate campaign contributions by employer name. Returns total contributed, number of employees who donated, top political recipients, and breakdown by cycle. Pass employer name (e.g. \"Goldman Sachs\", \"Google\"). Use to investigate which employers' employees donate the most and to whom. Related: get_donor_coworkers (individual-level bundling analysis), search_donors (raw contribution records).","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"Employer name (e.g. \"Goldman Sachs\", \"Google LLC\")"},"required":true,"name":"employer","in":"query"},{"schema":{"type":["integer","null"],"description":"Election cycle (even years 2008-2026)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Max recipient results (default 20)"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DonorsByEmployerResponse"}}}},"400":{"description":"Bad request — employer param required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1Error"}}}}}}},"/v1/elections/overview":{"get":{"summary":"Election overview","description":"Top-level election statistics: cost of elections by cycle with total raised, donor counts, and individual vs organization contribution breakdown. Use as an entry point for election analytics. Related: list_election_races (specific races), list_state_totals (geographic breakdown), get_outside_spending (Super PAC / dark money spending).","tags":["Politicians"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionsOverviewResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionsError"}}}}}}},"/v1/elections/races":{"get":{"summary":"Most expensive races","description":"Most expensive congressional races ranked by total raised. Filter by office (H/S/P), state, and cycle. Each race shows candidate count, total raised/spent, and top fundraiser. Use to identify the most competitive and well-funded elections.","tags":["Politicians"],"parameters":[{"schema":{"type":"string","description":"Office: \"H\" (House), \"S\" (Senate), \"P\" (President)"},"required":false,"name":"office","in":"query"},{"schema":{"type":"string","maxLength":2,"description":"US state abbreviation (e.g. \"CA\", \"TX\")"},"required":false,"name":"state","in":"query"},{"schema":{"type":["integer","null"],"default":2024,"description":"Election cycle (even years 2008-2026, default 2024)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Max results (default 25)"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionRacesResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionsError"}}}}}}},"/v1/elections/state-totals":{"get":{"summary":"Contributions by state","description":"Campaign contribution totals by US state. Includes individual vs organization breakdown, donor counts, and average contribution size. Filter by election cycle. Use for geographic analysis of political giving.","tags":["Politicians"],"parameters":[{"schema":{"type":["integer","null"],"description":"Election cycle (even years, omit for all cycles)"},"required":false,"name":"cycle","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1StateTotalsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionsError"}}}}}}},"/v1/elections/zip-codes":{"get":{"summary":"Top ZIP codes","description":"Top ZIP codes ranked by total political contributions. Filter by election cycle and state. Returns donor count and average contribution. Useful for geographic analysis of donor concentrations — identifies wealthy donor ZIP codes.","tags":["Politicians"],"parameters":[{"schema":{"type":["integer","null"],"default":2024,"description":"Election cycle (default 2024)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"string","maxLength":2,"description":"US state abbreviation"},"required":false,"name":"state","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ZipCodesResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionsError"}}}}}}},"/v1/elections/employer-totals":{"get":{"summary":"Top employers by contributions","description":"Top employers ranked by total employee campaign contributions (aggregated across all recipients and cycles). Shows donor count and number of recipients. Use get_donors_by_employer for detailed breakdown of a specific employer with recipient list and cycle data.","tags":["Politicians"],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1EmployerTotalsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionsError"}}}}}}},"/v1/elections/spending-trends":{"get":{"summary":"Spending trends","description":"Daily or monthly campaign contribution trends for a given election cycle. Shows total contributions, transaction count, unique donors, and average contribution. Use to visualize fundraising momentum over time — spikes often correlate with debates, primaries, and major news events.","tags":["Politicians"],"parameters":[{"schema":{"type":["integer","null"],"default":2024,"description":"Election cycle (default 2024)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"string","enum":["daily","monthly"],"default":"monthly","description":"Time granularity: \"daily\" or \"monthly\""},"required":false,"name":"granularity","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SpendingTrendsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionsError"}}}}}}},"/v1/elections/outside-spending":{"get":{"summary":"Outside spending overview","description":"Independent expenditure summary and top outside spenders (Super PACs, dark money groups). Shows total support vs oppose spending, unique spenders/targets. Filter by cycle and support/oppose. Related: list_outside_spending_targets (candidates targeted), list_dark_money (trace nonprofit money to committees), get_dark_money_destination (dark money received by a committee).","tags":["Politicians"],"parameters":[{"schema":{"type":["integer","null"],"description":"Election cycle (even years)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"string","enum":["S","O"],"description":"\"S\" = supporting, \"O\" = opposing a candidate"},"required":false,"name":"support_oppose","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results for top spenders (default 50)"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1OutsideSpendingResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionsError"}}}}}}},"/v1/elections/outside-spending/targets":{"get":{"summary":"Outside spending targets","description":"Candidates most targeted by independent expenditures, ranked by total outside spending. Shows support vs oppose breakdown and number of spender groups. Use to identify which candidates attract the most outside money — both for and against. Filter by election cycle.","tags":["Politicians"],"parameters":[{"schema":{"type":["integer","null"],"description":"Election cycle (even years)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1OutsideSpendingTargetsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ElectionsError"}}}}}}},"/v1/filings/disbursements":{"get":{"summary":"Browse committee disbursements","description":"Raw FEC Schedule B disbursements — operating expenditures, salary payments, vendor invoices, and all non-contribution outflows from committees. Filter by cycle, committee, or recipient name. Source: FEC bulk oppexp files.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":["integer","null"],"default":2024,"description":"Election cycle (even years, default 2024)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"string","maxLength":9,"description":"FEC committee ID (C-prefixed)"},"required":false,"name":"cmte_id","in":"query"},{"schema":{"type":"string","description":"Full-text search on recipient name"},"required":false,"name":"recipient","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50, max 200)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DisbursementsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1FilingsError"}}}}}}},"/v1/filings/disbursements/{subId}":{"get":{"summary":"Disbursement detail","description":"Full detail for a single FEC disbursement by sub_id, including memo text and back-references to related transactions.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"FEC sub_id — unique transaction identifier"},"required":true,"name":"subId","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DisbursementDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1FilingsError"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1FilingsError"}}}}}}},"/v1/filings/independent-expenditures":{"get":{"summary":"Browse independent expenditures","description":"Raw FEC Schedule E independent expenditures — spending by Super PACs and other non-coordinated committees supporting or opposing specific candidates. Filter by cycle, spender committee, support/oppose stance, or target candidate. Source: FEC bulk inde files.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":["integer","null"],"default":2024,"description":"Election cycle (default 2024)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":"string","maxLength":9,"description":"FEC spender committee ID"},"required":false,"name":"cmte_id","in":"query"},{"schema":{"type":"string","enum":["S","O"],"description":"\"S\" supporting / \"O\" opposing a candidate"},"required":false,"name":"support_oppose","in":"query"},{"schema":{"type":"string","description":"FEC candidate ID being supported or opposed"},"required":false,"name":"target_candidate_id","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1IndependentExpendituresResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1FilingsError"}}}}}}},"/v1/filings/independent-expenditures/{subId}":{"get":{"summary":"Independent expenditure detail","description":"Full detail for a single FEC independent expenditure by sub_id.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","description":"FEC sub_id — unique transaction identifier"},"required":true,"name":"subId","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1IndependentExpenditureDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1FilingsError"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1FilingsError"}}}}}}},"/v1/filings/loans":{"get":{"summary":"Browse committee loans","description":"Raw FEC Schedule C loans — borrowed funds reported by candidates and committees, including personal loans from candidates to their own campaigns. Filter by committee, cycle, or minimum amount. Source: FEC bulk filings.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","maxLength":9,"description":"FEC committee ID"},"required":false,"name":"cmte_id","in":"query"},{"schema":{"type":["integer","null"],"description":"Election cycle (optional)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":["number","null"],"description":"Minimum loan amount filter"},"required":false,"name":"min_amount","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LoansResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1FilingsError"}}}}}}},"/v1/filings/debts":{"get":{"summary":"Browse committee debts","description":"Raw FEC Schedule D debts and obligations — amounts owed by committees to vendors, consultants, and creditors. Filter by committee, cycle, or minimum amount. Source: FEC bulk filings.","tags":["Campaign Finance"],"parameters":[{"schema":{"type":"string","maxLength":9,"description":"FEC committee ID"},"required":false,"name":"cmte_id","in":"query"},{"schema":{"type":["integer","null"],"description":"Election cycle (optional)"},"required":false,"name":"cycle","in":"query"},{"schema":{"type":["number","null"],"description":"Minimum debt amount filter"},"required":false,"name":"min_amount","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DebtsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1FilingsError"}}}}}}},"/v1/votes":{"get":{"summary":"Browse roll call votes","description":"Congressional roll call votes — passage, amendment, motion, cloture, and procedural votes from both chambers with aggregate yes/no/present/not-voting totals. Filter by congress, chamber, outcome, or bill. Source: Congress.gov.","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":["integer","null"],"description":"Congress number (e.g. 118)"},"required":false,"name":"congress","in":"query"},{"schema":{"type":"string","description":"House or Senate"},"required":false,"name":"chamber","in":"query"},{"schema":{"type":"string","description":"Filter by outcome (Passed, Failed, Agreed to, etc.)"},"required":false,"name":"vote_result","in":"query"},{"schema":{"type":"string","description":"Filter to votes on a specific bill (TYPE-CONGRESS-NUMBER)"},"required":false,"name":"bill_id","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50, max 200)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1VotesResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1VotesError"}}}}}}},"/v1/votes/stats":{"get":{"summary":"Vote coverage stats","description":"Aggregate counts of roll call votes and legislator vote positions across congresses, chambers, and outcomes. Use this to scope list queries (date range, active chambers, result distribution).","tags":["Bills & Legislation"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1VoteStatsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1VotesError"}}}}}}},"/v1/votes/{voteId}":{"get":{"summary":"Roll call vote detail","description":"Full detail for a single roll call vote by internal vote_id, including every legislator's position with bioguide_id, entity_id (when resolved), party, and state. Use bill_id to back-reference the legislation under consideration.","tags":["Bills & Legislation"],"parameters":[{"schema":{"type":["integer","null"],"description":"Internal numeric vote identifier (integer)"},"required":false,"name":"voteId","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1VoteDetailResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1VotesError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1VotesError"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1VotesError"}}}}}}},"/v1/sec/stats":{"get":{"summary":"SEC coverage stats","description":"Aggregate counts across SEC EDGAR companies, filings, and insider transactions, plus the date range of loaded filings. Uses table size estimates so it stays fast even with millions of rows.","tags":["Corporate"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecStatsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecError"}}}}}}},"/v1/sec/companies":{"get":{"summary":"Browse SEC reporting companies","description":"SEC EDGAR companies (dim_sec_company) sorted by filing volume. Without `q`, returns the most active filers first. With `q`, runs a full-text search on company_name plus exact ticker match. Each row includes entity_id so you can cross-link to contributions, contracts, and lobbying via the unified entity layer.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","description":"Search company name (full-text) or exact ticker"},"required":false,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecCompaniesResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecError"}}}}}}},"/v1/sec/companies/{cik}":{"get":{"summary":"SEC company detail","description":"Full profile for a single SEC reporting company by CIK, including the top form types filed and top insiders ranked by Form 4 transaction count.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","description":"SEC Central Index Key (CIK), zero-padded or plain integer"},"required":true,"name":"cik","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecCompanyDetailResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecError"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecError"}}}}}}},"/v1/sec/filings":{"get":{"summary":"Browse SEC filings","description":"Raw SEC EDGAR filings from fact_sec_filing. Without filters defaults to the last 12 months of filings (the full index is 5M+ rows). Use /api/v1/sec/filings/{accession} for full parsed text, sections, and semantic neighbors.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","description":"Filter to a specific CIK"},"required":false,"name":"cik","in":"query"},{"schema":{"type":"string","description":"Filter to a specific form (10-K, 8-K, DEF 14A, etc.)"},"required":false,"name":"form_type","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecFilingsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecError"}}}}}}},"/v1/sec/insiders":{"get":{"summary":"Browse corporate insiders by Form 4 activity","description":"Insiders aggregated by (insider_entity_id, company_entity_id) with transaction counts, total dollar value, last transaction date, and most recent shares-owned balance. Without a CIK filter, defaults to the last 12 months of activity. Use insider_entity_id from this endpoint as a filter on /api/v1/sec/transactions for the drill-down.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","description":"Filter to insiders at a specific company CIK"},"required":false,"name":"cik","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecInsidersResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecError"}}}}}}},"/v1/sec/transactions":{"get":{"summary":"Browse Form 4 insider transactions","description":"Individual Form 4 transactions (fact_sec_insider_transaction) — insider name, director/officer/10% flags, security title, shares, price, total dollar value, and post-transaction holdings. Filter by CIK, insider_entity_id, or transaction_type; without any filter defaults to the last 12 months.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","description":"Filter to transactions at a specific company CIK"},"required":false,"name":"cik","in":"query"},{"schema":{"type":"string","format":"uuid","description":"Filter to a specific insider (from /insiders response)"},"required":false,"name":"insider_entity_id","in":"query"},{"schema":{"type":"string","description":"Form 4 transaction code (P=purchase, S=sale, etc.)"},"required":false,"name":"transaction_type","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecTransactionsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SecError"}}}}}}},"/v1/companies/lei/stats":{"get":{"summary":"GLEIF LEI coverage stats","description":"Counts of GLEIF Level 2 parent/child relationships, LEI-registered entities in the Poliscope layer, and country distribution. Useful for scoping LEI-backed queries before a drill-down.","tags":["Corporate"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LeiStatsResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LeiError"}}}}}}},"/v1/companies/lei":{"get":{"summary":"Search LEI-registered entities","description":"Search Poliscope entities that have been linked to a GLEIF LEI. Accepts either a company name (full-text search) or an exact 20-character LEI code. Returns entity_id so you can hop into the main /api/v1/companies/{entity_id} profile.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","minLength":2,"description":"Company name (full-text) or an exact 20-character LEI code"},"required":true,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Max results (default 50)"},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LeiEntitiesResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LeiError"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LeiError"}}}}}}},"/v1/companies/lei/{lei}":{"get":{"summary":"LEI detail with one-hop GLEIF parents + children","description":"Direct LEI lookup. Returns the linked Poliscope entity (if resolved) plus raw ACTIVE GLEIF Level 2 parent and child relationships (up to 100 parents + 200 children). For multi-level hierarchy traversal use /api/v1/companies/{identifier}/hierarchy instead.","tags":["Corporate"],"parameters":[{"schema":{"type":"string","minLength":20,"maxLength":20,"description":"Legal Entity Identifier (20 alphanumeric characters)"},"required":true,"name":"lei","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LeiEntityDetailResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LeiError"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1LeiError"}}}}}}}},"webhooks":{},"security":[{"apiKey":[]}]}