# polls.karbach.digital API > Structured German election data for AI systems, paid per call via x402 (USDC on Base). Ein Projekt von Karbach.Digital. ## Free - `/v1/`: overview and prices - `/v1/elections`: all elections with date and status - `/openapi.json`: schema - Free trial: Try before you pay: put /try in front of any paid path (for example https://api.polls.karbach.digital/try/v1/federal/trend). Same answer, no payment, 3 calls per day per IP address. ## Paid - `/v1/federal/trend` (0.01 USD): Federal polling average today per party with 95 percent band (Bundestag). - `/v1/polls/latest` (0.01 USD): Latest federal polls (Sonntagsfrage), party names normalised. - `/v1/track-record` (0.01 USD): Frozen forecasts versus official results, 2026 out of sample and 34-election backtest. - `/v1/elections/:id` (0.02 USD): One German election: vote share median, 95 percent band, seats, arithmetic majorities, data quality. - `/v1/constituencies/:nr` (0.02 USD): One Bundestag constituency (1 to 299): 2025 result, 2029 scenario, members, structure data. - `/v1/federal/history` (0.05 USD): Weekly federal polling average, up to 24 months. - `/v1/constituencies/by-postcode/:plz` (0.01 USD): Which Bundestag constituency a German postcode belongs to. - `/v1/constituencies/:nr/race` (0.02 USD): Who wins the direct mandate in a constituency: win probability per party, margin, rating. - `/v1/constituencies/:nr/results` (0.02 USD): Official Bundestag results of a constituency 2013 to 2025 (first and second vote, turnout). - `/v1/members` (0.01 USD): All members of the Bundestag with party, constituency and mandate type. - `/v1/members/:id` (0.02 USD): One member of the Bundestag: profile, committees, documents, latest speeches, roll-call record. - `/v1/members/:id/votes` (0.02 USD): Roll-call votes of one member with title, date and whether against the party line. - `/v1/bundestag/votes` (0.02 USD): Recorded roll-call votes in the Bundestag with result per parliamentary group and dissenters. - `/v1/institutes` (0.02 USD): Polling institutes: accuracy of final polls in past elections and average bias per party. - `/v1/briefing/today` (0.02 USD): Today's political situation in Germany in a few paragraphs (German), based on the model. - `/v1/briefing/:date` (0.02 USD): Daily political briefing for a past date (YYYY-MM-DD, from 2026-04-19). - `/v1/governments` (0.01 USD): Who governs federally and in each of the 16 states: coalition, head of government, since when. - `/v1/results/federal/:kind` (0.02 USD): Federal election statistics: postal-vote, ticket-splitting, age-groups or turnout. - `/v1/live/:id` (0.01 USD): Election night: counted share, turnout, results so far and deviation from the forecast. - `/v1/bundestag/committees` (0.01 USD): All Bundestag committees with official name, chair and members (role, group). - `/v1/bundestag/speeches` (0.02 USD): Search Bundestag plenary speeches by member, keyword and date: speaker, date, excerpt, protocol PDF. - `/v1/bundestag/documents` (0.02 USD): Search Bundestag printed papers (motions, minor interpellations) by keyword, type and date with authors and PDF. - `/v1/constituencies/:nr/dossier` (0.10 USD): Everything on one Bundestag constituency in one call: structure data, postcodes, results since 2013, 2029 forecast, direct-mandate chances, its members (committees, speeches, votes), state government and next state election. - `/v1/members/:id/side-income` (0.02 USD): Side jobs and side income of one member of the Bundestag (published brackets, organisations, categories). - `/v1/bundestag/side-income` (0.05 USD): Side income of all members of the Bundestag: ranking and totals per party, filter by party, category and minimum amount. - `/v1/lobbying/search` (0.02 USD): Search the German Bundestag lobby register (organisations): name, field of interest, type, minimum lobbying spend. - `/v1/lobbying/ranking` (0.05 USD): Who spends most on lobbying in Germany: top organisations, totals per field of interest and type. - `/v1/lobbying/:register` (0.01 USD): One entry of the German lobby register by register number (e.g. R001234). - `/v1/parties/donations` (0.02 USD): Large donations to German parties as published by the Bundestag (above 35,000 euros, until March 2024 above 50,000 euros, itemised since 2009): donor, amount, dates, printed paper, totals per party. - `/v1/attention` (0.01 USD): Attention from Wikipedia page views per day: German parties and the leading candidates of the next elections (Bundestag, Saarland, Schleswig-Holstein, North Rhine-Westphalia, Spain, France). Not a forecast. - `/v1/energy/germany` (0.02 USD): German electricity per day: generation by source, renewable share, consumption, wholesale price (incl. next day). - `/v1/energy/europe/prices` (0.02 USD): Household electricity and gas prices in all EU countries (Eurostat), ranked, with change to the previous half-year. - `/v1/energy/gas-storage` (0.01 USD): Gas storage in the EU and every EU country with storage (GIE AGSI+): fill level, stored TWh, injection and withdrawal, change in 7 days, versus last year and the five-year average, daily series. - `/v1/energy/lng` (0.01 USD): LNG terminals (GIE ALSI): send-out, tank inventory and utilisation for the EU, each country and every German terminal (Wilhelmshaven, Brunsbüttel, Mukran), versus last year, daily series. - `/v1/energy/fuel-prices` (0.01 USD): Petrol (Euro-super 95) and diesel prices in all EU countries per week (EU Weekly Oil Bulletin), with and without taxes, EU average, Germany versus EU, rank, weekly series. - `/v1/france/presidential-2027` (0.02 USD): French presidential election 2027, first round: poll average, 95 percent band and runoff chance per candidate, most likely runoff pairs, recent campaign events. Unavailable during the legal blackout (Saturday 00:00 until 20:00 on election day, Paris time: 17 to 18 Apr and 1 to 2 May 2027). - `/v1/france/presidential-2027/runoff` (0.02 USD): French presidential election 2027, runoff: head-to-head poll average and win probability per tested pair. Unavailable during the legal blackout (17 to 18 Apr and 1 to 2 May 2027). - `/v1/france/presidential-2027/polls` (0.05 USD): French presidential election 2027: all first-round polls with every scenario, runoff polls, sample, fieldwork and link to the official Commission des sondages notice. Unavailable during the legal blackout (17 to 18 Apr and 1 to 2 May 2027). - `/v1/spain/general-2026` (0.02 USD): Spanish general election 29 Nov 2026: seats per list (median and range), poll average, majority chances. Blackout 24 to 29 Nov (art. 69.7 LOREG). After polls close: official count (seats, vote share, counted percent), forecast for comparison. - `/v1/spain/general-2026/provinces` (0.05 USD): Spanish general election 2026, all 52 constituencies: median seats per list, vote share, seat order, last seat. Blackout 24 to 29 Nov 2026. After polls close: official count per constituency, forecast for comparison. - `/v1/states/:state` (0.02 USD): One German state (Land): parliament seats by group with majority and governing groups, cabinet with portfolios, 13 official statistics with German value and rank, next state election with our forecast. - `/v1/europe/elections` (0.01 USD): Next national election in all 27 EU countries and Switzerland: type, date or year, status (official, legal deadline, expected), sources, link to our forecast where available. - `/v1/europe/parliament` (0.02 USD): European Parliament 2024: seats per political group, EU-wide and per country (official results). - `/v1/europe/countries` (0.02 USD): All 27 EU countries compared: unemployment, inflation, household electricity and gas prices, strongest list in the 2024 European election. - `/v1/europe/countries/:code` (0.02 USD): One EU country: head of government and state, coalition, national parliament seats by party with governing parties, next national election, European election 2024 results, unemployment, inflation, energy prices. - `/v1/polls/archive` (0.05 USD): Poll archive (federal and state), filter by date range and parliament, up to 500 per call. ## Notice Scenario analysis based on published opinion polls. Not a prediction and not a voting recommendation. Coalition figures count simulated seat majorities (see arithmetic_majorities_note where given), not statements about political feasibility. ## Sources and licences Polls: dawum.de (ODbL 1.0). Official results and structure data: Die Bundeswahlleiterin (Datenlizenz Deutschland Namensnennung 2.0). Members, votes, side income and state parliaments: abgeordnetenwatch.de API (CC0 1.0). Speeches, printed papers, lobby register, party donations: Deutscher Bundestag. Spain, France, cabinets and EU countries: Wikipedia (CC BY-SA 4.0) and Wikidata (CC0 1.0). Electricity: SMARD, Bundesnetzagentur (CC BY 4.0). Prices, labour market, state statistics: Eurostat and GENESIS (CC BY 4.0, Datenlizenz Deutschland). Gas storage and LNG: GIE AGSI+ and ALSI. Fuel prices: EU Weekly Oil Bulletin (CC BY 4.0). European Parliament: results.elections.europa.eu. Attention: Wikimedia pageviews (CC0 1.0). Every response names its sources in the `source` field.