Entity: CandidacyMandate

Die mit Kandidaturen und Mandaten verbundenen Daten sind etwas komplexer, weswegen es folgende "Unter-Entitäten" gibt - dies ist wichtig, um später nach Daten filtern zu können, die wiederum in diesen "Unter-Entitäten" gespeichert sind. Die Felder dieser Entitäten sind weiter unten beschrieben, wir haben außerdem zusätzliche Filter gebaut, mit denen die Filterung von Kandidaturen und Mandaten erleichtert werden soll.

  • ElectoralData - hier sind Daten wie Wahlkreis, Wahlliste, Wahlkreisergebnis abgepeichert.
  • FractionMembership - nur relevant für Mandate. Während eines Mandats kann die Fraktion gewechselt werden. Um dies abbilden zu können, wird die Fraktionszugehörigkeit über diese Entität gepflegt, in der auch Eintritts- und Austrittsdatum für jede einzelne Mitgliedschaft gepflegt werden kann.
  • https://www.abgeordnetenwatch.de/api/v2/candidacies-mandates
  • Kandidatur: https://www.abgeordnetenwatch.de/api/v2/candidacies-mandates/5
  • Mandat: https://www.abgeordnetenwatch.de/api/v2/candidacies-mandates/38659
  • Mandat: https://www.abgeordnetenwatch.de/api/v2/candidacies-mandates/38659?related_data=show_information

Außerdem wichtig zu beachten

In unserem Datenbestand sind zahlreiche Kandidaturen und Mandate aus 15 Jahren abgeordnetenwatch.de. Zudem scheiden Abgeordnete manchmal vor dem Ende einer Legislatur aus dem Parlament aus, andere rücken nach. Wir bieten für diese Daten daher spezielle Filter an - zusätzlich zu den Feldern der Entität. Hinweise dazu finden Sie ganz unten.

Kleiner Tipp: Auf den Detailseiten eines Politikers und einer Parlamentsperiode befindet sich ein "OpenData" Button, in dem man die Id für den jeweiligen Politiker oder die Parlamentsperiode herausfinden kann. Außerdem findet man hier auch den Pfad zum Abrufen aller Kandidaturen/Mandate für einen Politiker oder eine Parlamentsperiode.

Felder
Name Beschreibung Datentyp Filter
id Die eindeutige Id der Entität Integer Keine Einschränkung.
entity_type Die eindeutige Id des Entitätstyps. String Nicht filterbar.
label Das Label ist bei diesen Entitäten zusammengesetzt aus Vor- und Nachname und dem Label der dazu gehörigen Parlamentsperiode. String Keine Einschränkung.
api_url Der API-Pfad, unter dem die einzelne Entität aufgerufen werden kann. String Nicht filterbar.
id_external_administration Feld für eine Id, welche für die Kandidatur oder das Mandat von einer externen Instanz vergeben wurde. Bei Bundestagsmandaten ist das z.B. die Id des Politikers in der Bundestagsverwaltung. String Keine Einschränkung.
id_external_administration_description Hinweis darüber, was für eine Id in id_external_administration definiert ist. String Keine Einschränkung.
type Der Typ der Entität, kann "candidacy" (= Kandidatur) oder "mandate" (= Mandat) sein. String Keine Einschränkung.
parliament_period Definiert die ParlamentPeriod, zu der diese Kandidatur / das Mandat gehört. Für ein Mandat ist nur eine Legislatur, für eine Kandiatur nur eine Wahl als Referenz erlaubt. Referenz -> ParliamentPeriod Es kann nach der Id der ParlamentPeriod gefiltert werden. Hinweise zur Filterung mit Referenzfeldern
politician Definiert den / die Politiker:in, zu der die Kandidatur / das Mandat gehört. Referenz -> Politician Es kann nach der Id des Politikers gefiltert werden. Hinweise zur Filterung mit Referenzfeldern
party Die Partei, für die bei einer Kandidatur angetreten wurde - dies muss nicht die gleiche Partei sein, dessen Mitglied ein:e Politiker:in ist. Ist nur bei Kandidaturen gepflegt Referenz -> Party Es kann nach der Id des Politikers gefiltert werden. Hinweise zur Filterung mit Referenzfeldern
start_date Das Startdatum der Kandidatur / des Mandats im Format 2022-01-21. Dieser Wert ist in der Regel NULL und nur definiert, wenn sich das Startdatum vom Startdatum der Parlamentsperiode unterscheidet. Konkretes Beispiel: ein Nachrückermandat, wenn jemand etwa nach dem Tod eines Politikers / einer Politikerin in das Parlament nachrückt. Date Keine Einschränkung.
end_date Das Enddatum der Kandidatur / des Mandats im Format 2022-01-21. Dieser Wert ist in der Regel NULL und nur definiert, wenn sich das Enddatum vom Enddatum der Parlamentsperiode unterscheidet. Konkretes Beispiel: ein:e Mandatsträger:in tritt zurück. Date Keine Einschränkung.
info Ein Freitextfeld, in das wir zusätzliche Informationen andere Hinweise über die Kandidatur / das Mandat vermerken. String Keine Einschränkung.
electoral_data Referenz auf eine ElectoralData Entität. Diese sind "Unter-Entitäten" für CandidacyMandate, welche allerdings ohne Kandidatur/Mandat keinen Sinn ergeben. Für diese Entitäten gibt es keine eigenen API-Pfade, se sind ausschließlich über Referenz Keine Filterung nach einer ElectoralData Id sinnvoll, es kann aber nach den Feldern innerhalb dieser Entität gefiltert werden.
electoral_data -> electoral_list Wenn der / die Politiker:in auf einer Wahlliste stand, ist hier die entsprechende Wahlliste referenziert. Referenz -> ElectoralList Es kann nach der Id der Wahlliste bzw. nach Feldern in der Wahlliste gefiltert werden. Bitte beachten: die Filterung erfolgt über die Verkettung der Referenz in electoral_data, also z.B. electoral_data[entity.electoral_list]=2 für die Filterung nach einer Wahlliste mit der Id 2 oder electoral_data[entity.electoral_list.entity.name]=Landesliste für die Filterung nach einer Wahlliste mit dem Namen "Landesliste". Hinweise zur Filterung mit Referenzfeldern
electoral_data -> list_position Wenn der / die Politiker:in auf einer Wahlliste stand, ist hier die Position auf der Wahlliste definiert. Integer Keine Einschränkung. Bitte beachten: die Filterung erfolgt über die Verkettung der Referenz in electoral_data, also z.B. electoral_data[entity.list_position]=2 für die Filterung nach der Listenposition 2. Hinweise zur Filterung mit Referenzfeldern
electoral_data -> constituency Wenn der / die Politiker:in ein einem Wahlkreis angetreten ist, ist hier dier entsprechende Wahlkreis referenziert. Referenz -> Constituency Es kann nach der Id des Wahlkreises bzw. nach Feldern in der Wahlkreis-Entität gefiltert werden. Bitte beachten: die Filterung erfolgt über die Verkettung der Referenz in electoral_data, also z.B. electoral_data[entity.constituency]=2 für die Filterung nach einer Wahlliste mit der Id 2 oder electoral_data[entity.constituency.entity.name]=Friedrichshain-Nord für die Filterung nach einem Wahlkreis mit dem Namen "Friedrichshain-Nord". Hinweise zur Filterung mit Referenzfeldern
electoral_data -> constituency_result Das Wahlergebnis in dem jeweiligen Wahlkreis in Prozent. Dezimalzeichen ist der Punkt Float Keine Einschränkung. Bitte beachten: die Filterung erfolgt über die Verkettung der Referenz in electoral_data, also z.B. electoral_data[entity.constituency_result][lt]=30 für die Filter nach solchen Wahlergebnissen, die weniger als 30 % erreichten. Hinweise zur Filterung mit Referenzfeldern
electoral_data -> constituency_result_count Bei manchen Parlamentswahlen werden die absoluten Stimmen gepflegt, weil diese relevant sind. Das ist insbesondere in Hamburg der Fall. Integer Keine Einschränkung. Bitte beachten: die Filterung erfolgt über die Verkettung der Referenz in electoral_data, also z.B. electoral_data[entity.constituency_result_count][lt]=1500 für die Filter nach solchen Wahlergebnissen, die weniger als 1.500 Stimmen erreicht haben erreichten. Hinweise zur Filterung mit Referenzfeldern
electoral_data -> mandate_won Wird in der Regel bei Kandiaturen und Mandaten gleichermaßen gepflegt. Zeigt an, ob und wie eine Kandidatur tatsächlich zu einem Mandat führte bzw. wie der / die Politiker:in zu dem Mandat kam. Mögliche Werte: constituency (Wahlkreis), list (Wahlliste), moved_up (Nachgerückt) String Keine Einschränkung. Bitte beachten: die Filterung erfolgt über die Verkettung der Referenz in electoral_data, also z.B. electoral_data[entity.mandate_won]=constituency für die Filter nach solchen Kandidaturen / Mandaten, die über die Direktwahl im Wahlkreis gewonnen wurden. Hinweise zur Filterung mit Referenzfeldern
fraction_membership Referenz auf eine oder mehrere FractionMembership Entitäten. Die FractionMembership ist eine "Unter-Entität" für CandidacyMandate, welche allerdings ohne Mandat keinen Sinn ergibt. Für diese Entität gibt es daher keine eigenen API-Pfade, sie ist in der API in die Entität CandidacyMandate integriert. Array von Referenzen Keine Filterung nach einer FractionMembership Id sinnvoll, es kann aber nach den Feldern innerhalb dieser Entität gefiltert werden.
fraction_membership -> label Der Name der Fraktion. String Nicht filterbar. Um nach Fraktion zu filtern, bitte die Referenz auf die Fraktion verwenden, siehe "fraction_membership -> fraction", oder den zusätzlichen Filter "fraction" verwenden.
fraction_membership -> fraction Die Fraktion, bei der / die Politiker:in Mitglied ist oder war. Referenz -> Fraction Es kann nach der Id der Fraktion bzw. nach Feldern in der Fraction-Entität gefiltert werden. Bitte beachten: die Filterung erfolgt über die Verkettung der Referenz in fraction_membership, also z.B. fraction_membership[entity.fraction]=2 für die Filterung nach einer Fraktion mit der Id 2 oder fraction_membership[entity.fraction.entity.label]=SPD für die Filterung nach einer Fraktion mit dem Namen "SPD". Hinweise zur Filterung mit Referenzfeldern
fraction_membership -> valid_from Das Datum, zu dem die Fraktionsmitgliedschaft begann, im Format 2022-01-21. Dieser Wert ist in der Regel NULL und nur definiert, wenn sich das Startdatum der Fraktionsmitgliedschaft vom Startdatum der Parlamentsperiode unterscheidet, also wenn ein Mandatsträger während der Legislatur eine Fraktion verlassen hat und einer anderen Fraktion beigetreten ist. Date Keine Einschränkung. Bitte beachten: die Filterung erfolgt über die Verkettung der Referenz in fraction_membership, also z.B. fraction_membership[entity.valid_from]=2020-01-01 für die Filterung nach Fraktionsmitgliedschaften, die am 01. Januar 2020 gestartet sind. Beachten Sie auch den zusätzlichen Filter fraction_current_on, siehe unten. Hinweise zur Filterung mit Referenzfeldern
fraction_membership -> valid_until Das Datum, zu dem die Fraktionsmitgliedschaft endete, im Format 2022-01-21. Dieser Wert ist in der Regel NULL und nur definiert, wenn sich das Enddatum der Fraktionsmitgliedschaft vom Enddatum der Parlamentsperiode unterscheidet, also wenn ein Mandatsträger während der Legislatur eine Fraktion verlassen hat und einer anderen Fraktion beigetreten ist. Date Keine Einschränkung. Bitte beachten: die Filterung erfolgt über die Verkettung der Referenz in fraction_membership, also z.B. fraction_membership[entity.valid_until]=2020-01-01 für die Filterung nach Fraktionsmitgliedschaften, die zum 01. Januar 2020 beendet wurden. Beachten Sie auch den zusätzlichen Filter fraction_current_on, siehe unten. Hinweise zur Filterung mit Referenzfeldern
Zusätzliche Filter
Name Beschreibung Datentyp Filter
current_on Ein Filter, mit dem nicht mehr aktuelle Kandidaturen / Mandate ausgefiltert werden können. Nicht mehr aktuell sind Kandidaturen / Mandate, wenn entweder die dazugehörige Parlamentsperiode beendet ist oder die Kandidatur zurückgezogen / das Mandat beendet wurde. String / Date Mögliche Werte:
  • now - zeigt heute aktuelle Kandidaturen / Mandate
  • Ein konkretes Datum im Format 2022-01-21 - listet Kandidaturen / Mandate auf, die zu diesem Zeitpunkt aktuell waren
fraction_current_on Hierman kann festgelegt werden, dass nur diejenige Fraktionsmitgliedschaft angezeigt werden soll, die zu einem bestimmten Zeitpunkt galt. String / Date Mögliche Werte:
  • now - heute aktuelle Fraktionsmitgliedschaften
  • Ein konkretes Datum im Format 2022-01-21
fraction Eine Kurzform für die Filterung nach Fraktion. Es kann nach der Id oder dem Kurznamen einer Fraktion gefiltert werden. String / Integer Eine Kurzschreibweise für "fraction_membership[entity.fraction]=2 bzw. "fraction_membership[entity.fraction.entity.name]=Fraktionsname. Stattdessen ist also fraction=2 oder fraction=Fraktionsname möglich. Eine weitere Verketttung / Filterung nach Feldern in der Fraction Entität ist nicht möglich.
electoral_list Eine Kurzform für die Filterung nach Wahlliste / ElectoralList. Es kann nach der Id oder dem Namen einer Wahlliste gefiltert werden. String / Integer Eine Kurzschreibweise für "electoral_data[entity.electoral_list]=2 bzw. "electoral_data[entity.electoral_list.entity.name]=Listename. Stattdessen ist also electoral_list=2 oder electoral_list=Listename möglich. Eine weitere Verketttung / Filterung nach Feldern in der Fraction Entität ist nicht möglich.
constituency Eine Kurzform für die Filterung nach Wahlkreis / Constituency. Es kann nach der Id oder dem Namen eines Wahlkreises gefiltert werden. String / Integer Eine Kurzschreibweise für "electoral_data[entity.constituency]=2 bzw. "electoral_data[entity.constituency.entity.name]=Wahlkreisname. Stattdessen ist also constituency=2 oder constituency=Wahlkreisname möglich. Eine weitere Verketttung / Filterung nach Feldern in der Constituency Entität ist nicht möglich.
constituency_nr Eine Kurzform für die Filterung nach Wahlkreis-Nummer. Integer Eine Kurzschreibweise für "electoral_data[entity.constituency.entity.number]=123. Stattdessen kann also constituency_nr=123 genutzt werden.
politician_first_name Eine Kurzform für die Filterung nach dem Vornamen eines Politikers / einer Politikern. String Eine Kurzschreibweise für "politician[entity.first_name]=Vorname. Stattdessen kann also politician_first_name=Vorname genutzt werden.
politician_last_name Eine Kurzform für die Filterung nach dem Familiennamen eines Politikers / einer Politikern. String Eine Kurzschreibweise für "politician[entity.last_name]=Nachname. Stattdessen kann also politician_last_name=Nachname genutzt werden.
politician_party Eine Kurzform für die Filterung nach der Partei eines Politikers / einer Politikern. Wichtig: Dies ist die persönliche, derzeitige Parteizugehörigkeit des Politikers - das muss nicht die gleiche Partei sein, für die er oder sie in einer Kandidatur angetreten ist, siehe oben bei "party" Integer / String Eine Kurzschreibweise für "politician[entity.party]=123 oder "politician[entity.party.entity.short_name]=Parteiname. Stattdessen kann also politician_party=123 oder politician_party=Parteiname genutzt werden. Eine weitere Verkettung mit Feldern aus der Politician oder Party Entität ist bei diesem Filter nicht möglich.