{"openapi":"3.1.0","info":{"title":"polls.karbach.digital API","description":"German election data for AI systems: polling averages with uncertainty, seats, arithmetic majorities, poll archive, constituencies. Paid per call via x402 (USDC). Ein Projekt von Karbach.Digital.","version":"1.0.0"},"paths":{"/v1/":{"get":{"summary":"Overview, prices, how to pay (free)","operationId":"ueberblick_v1__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/status":{"get":{"summary":"Freshness and plausibility of every dataset (free)","operationId":"stand_v1_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/elections":{"get":{"summary":"All elections with date and status (free)","operationId":"liste_wahlen_v1_elections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/federal/trend":{"get":{"summary":"Federal polling average with 95 percent band (0.01 USD)","operationId":"bund_trend_v1_federal_trend_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"Federal polling average today per party with 95 percent band (Bundestag). Use when asked how German parties currently stand nationally."}},"/v1/federal/history":{"get":{"summary":"Weekly federal average, up to 24 months (0.05 USD)","operationId":"bund_verlauf_v1_federal_history_get","parameters":[{"name":"months","in":"query","required":false,"schema":{"type":"integer","maximum":24,"minimum":1,"default":12,"title":"Months"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.05 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"description":"Weekly federal polling average, up to 24 months. Use when asked how party support developed over months."}},"/v1/polls/latest":{"get":{"summary":"Latest federal polls (0.01 USD)","operationId":"umfragen_neu_v1_polls_latest_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"Latest federal polls (Sonntagsfrage), party names normalised. Use when asked about the newest federal polls by institute."}},"/v1/polls/archive":{"get":{"summary":"Poll archive with filters (0.05 USD)","operationId":"umfragen_archiv_v1_polls_archive_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"To"}},{"name":"parliament","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Parliament"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":500,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.05 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"description":"Poll archive (federal and state), filter by date range and parliament, up to 500 per call. Use when you need many historic polls with fieldwork dates and sample sizes."}},"/v1/elections/{eid}":{"get":{"summary":"One election with seats and majorities (0.02 USD)","operationId":"wahl_v1_elections__eid__get","parameters":[{"name":"eid","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z]{2,4}-\\d{4}$","title":"Eid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"One German election: vote share median, 95 percent band, seats, arithmetic majorities, data quality. Use when asked who leads, who gets seats or which majorities are possible in a specific German state or federal election."}},"/v1/constituencies/{nr}":{"get":{"summary":"One Bundestag constituency (0.02 USD)","operationId":"wahlkreis_v1_constituencies__nr__get","parameters":[{"name":"nr","in":"path","required":true,"schema":{"type":"integer","maximum":299,"minimum":1,"title":"Nr"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"One Bundestag constituency (1 to 299): 2025 result, 2029 scenario, members, structure data. Use when asked about one Bundestag constituency."}},"/v1/track-record":{"get":{"summary":"Frozen forecasts against official results (0.01 USD)","operationId":"trefferbilanz_v1_track_record_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"Frozen forecasts versus official results, 2026 out of sample and 34-election backtest. Use when asked how reliable these forecasts were in past elections."}},"/v1/constituencies/by-postcode/{plz}":{"get":{"summary":"Constituency for a postcode (0.01 USD)","operationId":"wahlkreis_plz_v1_constituencies_by_postcode__plz__get","parameters":[{"name":"plz","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{5}$","title":"Plz"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"Which Bundestag constituency a German postcode belongs to. Use when you have a German postcode and need the constituency."}},"/v1/constituencies/{nr}/dossier":{"get":{"summary":"Complete constituency dossier (0.10 USD)","operationId":"wahlkreis_dossier_v1_constituencies__nr__dossier_get","parameters":[{"name":"nr","in":"path","required":true,"schema":{"type":"integer","maximum":299,"minimum":1,"title":"Nr"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.10 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"network":"eip155:8453","asset":"USDC"},"description":"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. Use when you need a complete briefing on one German constituency in a single call."}},"/v1/constituencies/{nr}/race":{"get":{"summary":"Direct mandate race in a constituency (0.02 USD)","operationId":"wahlkreis_rennen_v1_constituencies__nr__race_get","parameters":[{"name":"nr","in":"path","required":true,"schema":{"type":"integer","maximum":299,"minimum":1,"title":"Nr"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Who wins the direct mandate in a constituency: win probability per party, margin, rating. Use when asked who will win a constituency seat."}},"/v1/constituencies/{nr}/results":{"get":{"summary":"Official results of a constituency 2013 to 2025 (0.02 USD)","operationId":"wahlkreis_ergebnisse_v1_constituencies__nr__results_get","parameters":[{"name":"nr","in":"path","required":true,"schema":{"type":"integer","maximum":299,"minimum":1,"title":"Nr"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Official Bundestag results of a constituency 2013 to 2025 (first and second vote, turnout). Use when asked for past official results of a constituency."}},"/v1/members":{"get":{"summary":"All members of the Bundestag (0.01 USD)","operationId":"abgeordnete_liste_v1_members_get","parameters":[{"name":"party","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Party"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"All members of the Bundestag with party, constituency and mandate type. Use to find members of the Bundestag by party or state."}},"/v1/members/{mid}":{"get":{"summary":"One member of the Bundestag (0.02 USD)","operationId":"abgeordnete_v1_members__mid__get","parameters":[{"name":"mid","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{2,80}$","title":"Mid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"One member of the Bundestag: profile, committees, documents, latest speeches, roll-call record. Use when asked about a specific member of the Bundestag."}},"/v1/members/{mid}/side-income":{"get":{"summary":"Side income of one member (0.02 USD)","operationId":"nebeneinkuenfte_person_v1_members__mid__side_income_get","parameters":[{"name":"mid","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{2,80}$","title":"Mid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Side jobs and side income of one member of the Bundestag (published brackets, organisations, categories). Use when asked about side jobs, side income or conflicts of interest of a German MP."}},"/v1/bundestag/side-income":{"get":{"summary":"Side income of all members (0.05 USD)","operationId":"nebeneinkuenfte_uebersicht_v1_bundestag_side_income_get","parameters":[{"name":"party","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Party"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Category"}},{"name":"min_eur","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Min Eur"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":630,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.05 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"description":"Side income of all members of the Bundestag: ranking and totals per party, filter by party, category and minimum amount. Use when asked which German MPs or parties earn most on the side (Nebeneinkünfte)."}},"/v1/members/{mid}/votes":{"get":{"summary":"Roll-call votes of one member (0.02 USD)","operationId":"abgeordnete_stimmen_v1_members__mid__votes_get","parameters":[{"name":"mid","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{2,80}$","title":"Mid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Roll-call votes of one member with title, date and whether against the party line. Use when asked how a member voted."}},"/v1/bundestag/votes":{"get":{"summary":"Roll-call votes in the Bundestag (0.02 USD)","operationId":"abstimmungen_v1_bundestag_votes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Recorded roll-call votes in the Bundestag with result per parliamentary group and dissenters. Use when asked how parliamentary groups voted on a bill."}},"/v1/institutes":{"get":{"summary":"Accuracy and bias of polling institutes (0.02 USD)","operationId":"institute_v1_institutes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Polling institutes: accuracy of final polls in past elections and average bias per party. Use when asked which German polling institute is most accurate or biased."}},"/v1/briefing/today":{"get":{"summary":"Today's political briefing (0.02 USD)","operationId":"lage_heute_v1_briefing_today_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Today's political situation in Germany in a few paragraphs (German), based on the model. Use for a short summary of German politics today."}},"/v1/briefing/{tag}":{"get":{"summary":"Political briefing for a past date (0.02 USD)","operationId":"lage_archiv_v1_briefing__tag__get","parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Tag"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Daily political briefing for a past date (YYYY-MM-DD, from 2026-04-19). Use for the political situation on a past date."}},"/v1/governments":{"get":{"summary":"Federal and state governments (0.01 USD)","operationId":"regierungen_v1_governments_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"Who governs federally and in each of the 16 states: coalition, head of government, since when. Use when asked who governs in Germany or a German state."}},"/v1/results/federal/{art}":{"get":{"summary":"Federal election statistics (0.02 USD)","operationId":"ergebnisse_bund_v1_results_federal__art__get","parameters":[{"name":"art","in":"path","required":true,"schema":{"type":"string","pattern":"^(postal-vote|ticket-splitting|age-groups|turnout)$","title":"Art"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Federal election statistics: postal-vote, ticket-splitting, age-groups or turnout. Use for German voting statistics: postal vote, ticket splitting, age groups, turnout."}},"/v1/live/{eid}":{"get":{"summary":"Election night data (0.01 USD)","operationId":"live_v1_live__eid__get","parameters":[{"name":"eid","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z]{2,4}-\\d{4}$","title":"Eid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"Election night: counted share, turnout, results so far and deviation from the forecast. Use on German election nights for the current count."}},"/v1/bundestag/committees":{"get":{"summary":"Bundestag committees with members (0.01 USD)","operationId":"ausschuesse_v1_bundestag_committees_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"All Bundestag committees with official name, chair and members (role, group). Use when asked who sits on or chairs a Bundestag committee."}},"/v1/bundestag/speeches":{"get":{"summary":"Search plenary speeches (0.02 USD)","operationId":"reden_v1_bundestag_speeches_get","parameters":[{"name":"member","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[a-z0-9-]{2,80}$"},{"type":"null"}],"title":"Member"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":80},{"type":"null"}],"title":"Q"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"From"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Search Bundestag plenary speeches by member, keyword and date: speaker, date, excerpt, protocol PDF. Use when asked what a member or the Bundestag said on a topic."}},"/v1/bundestag/documents":{"get":{"summary":"Search printed papers (0.02 USD)","operationId":"drucksachen_v1_bundestag_documents_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":80},{"type":"null"}],"title":"Q"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Type"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"From"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Search Bundestag printed papers (motions, minor interpellations) by keyword, type and date with authors and PDF. Use when looking for parliamentary motions or questions on a topic."}},"/v1/lobbying/search":{"get":{"summary":"Search the lobby register (0.02 USD)","operationId":"lobby_suche_v1_lobbying_search_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":80},{"type":"null"}],"title":"Q"}},{"name":"field","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Field"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Type"}},{"name":"min_eur","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Min Eur"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Search the German Bundestag lobby register (organisations): name, field of interest, type, minimum lobbying spend. Use when asked who lobbies the German government on a topic, or about a specific lobby organisation."}},"/v1/lobbying/ranking":{"get":{"summary":"Lobbying spend ranking (0.05 USD)","operationId":"lobby_rangliste_v1_lobbying_ranking_get","parameters":[{"name":"field","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Field"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.05 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"description":"Who spends most on lobbying in Germany: top organisations, totals per field of interest and type. Use when asked who spends most on lobbying in Germany."}},"/v1/lobbying/{register}":{"get":{"summary":"One lobby register entry (0.01 USD)","operationId":"lobby_eintrag_v1_lobbying__register__get","parameters":[{"name":"register","in":"path","required":true,"schema":{"type":"string","pattern":"^[Rr]\\d{6}$","title":"Register"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"One entry of the German lobby register by register number (e.g. R001234). Use for full details of one lobby register entry."}},"/v1/parties/donations":{"get":{"summary":"Large donations to German parties (0.02 USD)","operationId":"grossspenden_v1_parties_donations_get","parameters":[{"name":"party","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":60},{"type":"null"}],"title":"Party"}},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2009},{"type":"null"}],"title":"Year"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"From"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"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. Use when asked who donates large sums to a German party, how much a party received in large donations, or about a specific donation (Großspende)."}},"/v1/attention":{"get":{"summary":"Attention from Wikipedia page views (0.01 USD)","operationId":"aufmerksamkeit_v1_attention_get","parameters":[{"name":"group","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[a-z_]{2,12}(-\\d{4})?$"},{"type":"null"}],"title":"Group"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":730,"minimum":1,"default":90,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"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. Use when asked how much public attention a German party or a leading candidate in Germany, Spain or France gets, or whether interest is rising. Not a measure of support."}},"/v1/energy/germany":{"get":{"summary":"German electricity per day (0.02 USD)","operationId":"energie_deutschland_v1_energy_germany_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"German electricity per day: generation by source, renewable share, consumption, wholesale price (incl. next day). Use when asked about German electricity: renewable share, generation mix, power prices, consumption."}},"/v1/energy/europe/prices":{"get":{"summary":"Household energy prices in Europe (0.02 USD)","operationId":"energie_europa_v1_energy_europe_prices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Household electricity and gas prices in all EU countries (Eurostat), ranked, with change to the previous half-year. Use when comparing electricity or gas prices for households across EU countries."}},"/v1/energy/gas-storage":{"get":{"summary":"Gas storage in the EU (0.01 USD)","operationId":"gasspeicher_v1_energy_gas_storage_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[A-Za-z]{2}$"},{"type":"null"}],"title":"Country"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":730,"minimum":1,"default":90,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"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. Use when asked how full German or European gas storage is, whether it is filling or emptying, or how it compares with last year and the five-year average."}},"/v1/energy/lng":{"get":{"summary":"LNG terminals in the EU and Germany (0.01 USD)","operationId":"lng_v1_energy_lng_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":730,"minimum":1,"default":90,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"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. Use when asked how much LNG Germany or the EU imports through its terminals, or how busy Wilhelmshaven, Brunsbüttel or Mukran are."}},"/v1/energy/fuel-prices":{"get":{"summary":"Petrol and diesel prices in the EU (0.01 USD)","operationId":"spritpreise_v1_energy_fuel_prices_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[A-Za-z]{2}(,[A-Za-z]{2}){0,9}$"},{"type":"null"}],"title":"Country"}},{"name":"weeks","in":"query","required":false,"schema":{"type":"integer","maximum":520,"minimum":1,"default":52,"title":"Weeks"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"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. Use when asked what petrol or diesel costs in Germany or another EU country, how prices changed, or how Germany compares with the EU average."}},"/v1/europe/parliament":{"get":{"summary":"European Parliament seats by group (0.02 USD)","operationId":"europa_parlament_v1_europe_parliament_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"European Parliament 2024: seats per political group, EU-wide and per country (official results). Use when asked about the European Parliament's political groups and seats."}},"/v1/europe/countries":{"get":{"summary":"EU countries compared (0.02 USD)","operationId":"europa_vergleich_v1_europe_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"All 27 EU countries compared: unemployment, inflation, household electricity and gas prices, strongest list in the 2024 European election. Use when comparing EU countries on unemployment, inflation, energy prices or European election results."}},"/v1/europe/countries/{code}":{"get":{"summary":"One EU country (0.02 USD)","operationId":"europa_land_v1_europe_countries__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"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. Use for a political and economic profile of one EU country, including who governs and how its parliament is composed."}},"/v1/france/presidential-2027":{"get":{"summary":"France 2027 presidential election, first round (0.02 USD)","operationId":"frankreich_prognose_v1_france_presidential_2027_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"French presidential election 2027, first round: poll average, 95 percent band and runoff chance per candidate, most likely runoff pairs, recent campaign events. Use when asked who leads the 2027 French presidential election or who reaches the runoff."}},"/v1/france/presidential-2027/runoff":{"get":{"summary":"France 2027 presidential election, runoff pairs (0.02 USD)","operationId":"frankreich_stichwahl_v1_france_presidential_2027_runoff_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"French presidential election 2027, runoff: head-to-head poll average and win probability per tested pair. Use when asked how a French presidential runoff between two candidates would end."}},"/v1/france/presidential-2027/polls":{"get":{"summary":"France 2027 presidential polls with scenarios (0.05 USD)","operationId":"frankreich_umfragen_v1_france_presidential_2027_polls_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.05 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"description":"French presidential election 2027: all first-round polls with every scenario, runoff polls, sample, fieldwork and link to the official Commission des sondages notice. Use when you need individual French presidential polls with scenarios and official notices."}},"/v1/spain/general-2026":{"get":{"summary":"Spain general election 2026, seat forecast (0.02 USD)","operationId":"spanien_prognose_v1_spain_general_2026_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"Spanish general election 29 Nov 2026: seat forecast per list (median and 90 percent range), poll average, majority chances (PP+Vox, Sanchez bloc, PP alone), strongest list. Unavailable during the legal blackout 24 to 29 Nov 2026 (art. 69.7 LOREG). Use when asked who wins the 2026 Spanish general election, how many seats PP, PSOE or Vox get, or whether PP and Vox reach a majority."}},"/v1/spain/general-2026/provinces":{"get":{"summary":"Spain general election 2026, 52 constituencies (0.05 USD)","operationId":"spanien_provinzen_v1_spain_general_2026_provinces_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.05 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"description":"Spanish general election 2026, all 52 constituencies: seats, median seats per list, modelled vote share, how many seats are in play, the order in which seats are allocated and who wins the last seat or is first left out. Use when asked about seats in a Spanish province (Madrid, Barcelona, ...) in 2026, or which party is fighting for the last seat there."}},"/v1/states/{state}":{"get":{"summary":"One German state: parliament, cabinet, statistics, next election (0.02 USD)","operationId":"land_v1_states__state__get","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: 0.02 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"description":"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. Use when asked who governs a German state, how its parliament is composed, who is in its cabinet, how it compares statistically, or who leads before its next election."}},"/v1/europe/elections":{"get":{"summary":"Next national election in every EU country and Switzerland (0.01 USD)","operationId":"eu_wahlen_v1_europe_elections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: 0.01 USD in USDC via x402."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"description":"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. Use when asked when the next national election is in an EU country or which European elections are coming up."}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"servers":[{"url":"https://api.polls.karbach.digital"}],"x-discovery":{"x402":"https://api.polls.karbach.digital/.well-known/x402","llms":"https://api.polls.karbach.digital/llms.txt"}}