# Ballotpedia API: List ballot measures > Lists statewide ballot measures in a US state and year, in Ballotpedia order, with election dates, topics, measure types, yes/no vote meanings and results. Years without statewide measures return an empty list. Unofficial. Not affiliated with or endorsed by Ballotpedia. - Page: https://fous.com/methods/ballotpedia.org/list-ballot-measures - Method: `ballotpedia.org/list_ballot_measures`, version 1 - Website: ballotpedia.org - Returns: measure name, topics, type, election date, yes/no vote meanings, result, vote percentages, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `year` | integer | yes | `2024` | Election year, for example 2024. | | `state` | string | yes | `"California"` | US state name or two-letter code, for example California. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "year": 2024, "state": "California" } ``` Its output: ```json { "measures": [ { "link": "https://ballotpedia.org/California_Proposition_1,_Behavioral_Health_Services_Program_and_Bond_Measure_(March_2024)", "type": "Legislatively referred state statute", "result": "approved", "topics": [ "Housing", "Healthcare facility", "Healthcare governance" ], "measure_name": "California Proposition 1", "election_date": "2024-03-05", "no_vote_means": "A \"no\" vote opposed changing the Mental Health Services Act and issuing $6.38 billion in bonds for homeless individuals and veterans.", "yes_vote_means": "A \"yes\" vote supported : renaming the Mental Health Services Act (2004) to the Behavioral Health Services Act and expanding its purpose to include substance use disorders, including for persons without a mental illness; changing how revenue from the 1% tax on income above $1 million is spent under t…", "no_vote_percentage": 49.82, "yes_vote_percentage": 50.18 }, { "link": "https://ballotpedia.org/California_Proposition_2,_Public_Education_Facilities_Bond_Measure_(2024)", "type": "Bond issue", "result": "approved", "topics": [ "Higher education funding", "Public education funding", "Bonds" ], "measure_name": "California Proposition 2", "election_date": "2024-11-05", "no_vote_means": "A \"no\" vote opposed issuing $10 billion in bonds to fund construction and modernization of public education facilities.", "yes_vote_means": "A \"yes\" vote supported issuing $10 billion in bonds to fund construction and modernization of public education facilities.", "no_vote_percentage": 41.3, "yes_vote_percentage": 58.7 }, { "link": "https://ballotpedia.org/California_Proposition_32,_$18_Minimum_Wage_Initiative_(2024)", "type": "Citizen-initiated state statute", "result": "defeated", "topics": [ "Minimum wage" ], "measure_name": "California Proposition 32", "election_date": "2024-11-05", "no_vote_means": "A \"no\" vote opposed this ballot initiative, thereby maintaining the existing law which set the minimum wage to $16 per hour for all employers as of January 2024.", "yes_vote_means": "A \"yes\" vote supported increasing the state minimum wage to $18 per hour by 2026 for all employers and thereafter adjusting the rate annually by increases to the cost of living.", "no_vote_percentage": 50.71, "yes_vote_percentage": 49.29 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ballotpedia.org/list_ballot_measures","input":{"year":2024,"state":"California"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What statewide ballot measures were on the ballot in Ohio in 2023, and did each one pass or fail? - Pull up Ballotpedia's list of 2024 California propositions with what a yes vote and a no vote meant for each - Show me every statewide measure Colorado voters decided in 2020, including topics and vote percentages - I need a rundown of Florida's 2018 constitutional amendments: measure type, election date, and final result - Using Ballotpedia, list the statewide ballot questions in MA for 2022 with yes/no meanings and results ## Input schema ```json { "type": "object", "required": [ "state", "year" ], "properties": { "year": { "type": "integer", "maximum": 2100, "minimum": 1800, "description": "Election year, for example 2024." }, "state": { "type": "string", "description": "US state name or two-letter code, for example California." } } } ``` ## Output schema ```json { "type": "object", "required": [ "measures" ], "properties": { "measures": { "type": "array", "items": { "type": "object", "required": [ "measure_name", "topics", "type", "election_date", "yes_vote_means", "no_vote_means", "result", "yes_vote_percentage", "no_vote_percentage", "link" ], "properties": { "link": { "type": "string" }, "type": { "type": [ "string", "null" ] }, "result": { "enum": [ "approved", "defeated", "upcoming" ], "type": "string" }, "topics": { "type": "array", "items": { "type": "string" } }, "measure_name": { "type": "string" }, "election_date": { "type": "string", "format": "date" }, "no_vote_means": { "type": "string" }, "yes_vote_means": { "type": "string" }, "no_vote_percentage": { "type": [ "number", "null" ] }, "yes_vote_percentage": { "type": [ "number", "null" ] } }, "additionalProperties": false }, "description": "Statewide measures in the order listed by Ballotpedia." } }, "additionalProperties": false } ``` ## See more - [Ballotpedia API: Get candidate profile](https://fous.com/methods/ballotpedia.org/get-candidate.md): Looks up a Ballotpedia candidate or officeholder profile by name, with election results, background and published links. An optional state narrows people with the same name; unreported details are left blank. - [ElectionGuide API: Get election results](https://fous.com/methods/electionguide.org/get-election-results.md): Gets a country's most recent held national election or referendum on ElectionGuide, optionally for a year and election type, with turnout and published candidate, party or option results. - [Oyez API: List term cases](https://fous.com/methods/oyez.org/list-term-cases.md): Lists Oyez Supreme Court cases for a term, sorted by argument date then name. Decision dates and vote splits are blank where Oyez does not provide them. - [Stock Analysis API: List recent IPOs](https://fous.com/methods/stockanalysis.com/list-recent-ipos.md): Lists US IPOs from a chosen year, newest first. Each IPO comes with its IPO price, current price and return since IPO. Coverage begins in 2019. - [Social Security Administration API: List top baby names](https://fous.com/methods/ssa.gov/list-top-baby-names.md): Lists the ranked top baby names and birth counts for a U.S. birth year, nationwide or for one state. - [GOV.UK API: List bank holidays](https://fous.com/methods/gov.uk/list-bank-holidays.md): Lists GOV.UK bank holidays for a UK region and year, including substitute days and notes, plus the next upcoming holiday. Years GOV.UK does not publish return an empty list and the published years. - [Nager.Date API: List public holidays](https://fous.com/methods/date.nager.at/list-public-holidays.md): Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types. - [Fortune API: List Fortune 500 companies](https://fous.com/methods/fortune.com/list-fortune-500.md): Lists the Fortune 500 for a year. You can filter by industry or sector and by headquarters state. Each company comes with its public financial and company details. - [All Ballotpedia methods](https://fous.com/methods/ballotpedia.org.md)