Skip to content
HALOWERK

Datenwerk

election results

Looks up the official final result published by the Federal Returning Officer (Die Bundeswahlleiterin, open data kerg2.csv, status final, 14 March 2025, dl-de/by-2-0) for the federal territory, the 16 states or the 299 constituencies by number or name: electorate, voters and turnout, invalid and valid votes, and for each party the first votes (Erststimmen) and second votes (Zweitstimmen) with shares and the 2021 comparison recalculated to the 2025 constituency boundaries. Names of elected.

POST https://daten.halowerk.com/v1/election-results

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
areastringYesArea name or number, e.g. Bundesgebiet, Bayern, 93, Köln I.
area_typestringNoRestrict the lookup (numbers need it unless they are constituencies).
votestringNo
topintegerNoNumber of parties returned (ordered by second votes, or first votes for vote=first).
include_previousbooleanNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "area"
  ],
  "properties": {
    "area": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Area name or number, e.g. Bundesgebiet, Bayern, 93, Köln I."
    },
    "area_type": {
      "type": "string",
      "enum": [
        "federal",
        "state",
        "constituency"
      ],
      "description": "Restrict the lookup (numbers need it unless they are constituencies)."
    },
    "vote": {
      "type": "string",
      "enum": [
        "first",
        "second",
        "both"
      ],
      "default": "both"
    },
    "top": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "default": 15,
      "description": "Number of parties returned (ordered by second votes, or first votes for vote=first)."
    },
    "include_previous": {
      "type": "boolean",
      "default": true
    }
  }
}

Open original schema

Published input example

{
  "area": "Bayern",
  "vote": "second",
  "top": 5
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →