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
NameBeschreibungDatentypFilter
idDie eindeutige Id der EntitätIntegerKeine Einschränkung.
entity_typeDie eindeutige Id des Entitätstyps.StringNicht filterbar.
labelDas Label ist bei diesen Entitäten zusammengesetzt aus Vor- und Nachname und dem Label der dazu gehörigen Parlamentsperiode.StringKeine Einschränkung.
api_urlDer API-Pfad, unter dem die einzelne Entität aufgerufen werden kann.StringNicht filterbar.
id_external_administrationFeld 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.StringKeine Einschränkung.
id_external_administration_descriptionHinweis darüber, was für eine Id in id_external_administration definiert ist.StringKeine Einschränkung.
typeDer Typ der Entität, kann "candidacy" (= Kandidatur) oder "mandate" (= Mandat) sein.StringKeine Einschränkung.
parliament_periodDefiniert 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 -> ParliamentPeriodEs kann nach der Id der ParlamentPeriod gefiltert werden. Hinweise zur Filterung mit Referenzfeldern
politicianDefiniert den / die Politiker:in, zu der die Kandidatur / das Mandat gehört.Referenz -> PoliticianEs kann nach der Id des Politikers gefiltert werden. Hinweise zur Filterung mit Referenzfeldern
partyDie 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 gepflegtReferenz -> PartyEs kann nach der Id des Politikers gefiltert werden. Hinweise zur Filterung mit Referenzfeldern
start_dateDas Startdatum der Kandidatur / des Mandats im Format 2024-03-29. 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.DateKeine Einschränkung.
end_dateDas Enddatum der Kandidatur / des Mandats im Format 2024-03-29. 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.DateKeine Einschränkung.
infoEin Freitextfeld, in das wir zusätzliche Informationen andere Hinweise über die Kandidatur / das Mandat vermerken.StringKeine Einschränkung.
electoral_dataReferenz 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 überReferenzKeine Filterung nach einer ElectoralData Id sinnvoll, es kann aber nach den Feldern innerhalb dieser Entität gefiltert werden.
electoral_data -> electoral_listWenn der / die Politiker:in auf einer Wahlliste stand, ist hier die entsprechende Wahlliste referenziert.Referenz -> ElectoralListEs 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_positionWenn der / die Politiker:in auf einer Wahlliste stand, ist hier die Position auf der Wahlliste definiert.IntegerKeine 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 -> constituencyWenn der / die Politiker:in ein einem Wahlkreis angetreten ist, ist hier dier entsprechende Wahlkreis referenziert.Referenz -> ConstituencyEs 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_resultDas Wahlergebnis in dem jeweiligen Wahlkreis in Prozent. Dezimalzeichen ist der PunktFloatKeine 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_countBei manchen Parlamentswahlen werden die absoluten Stimmen gepflegt, weil diese relevant sind. Das ist insbesondere in Hamburg der Fall.IntegerKeine 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_wonWird 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)StringKeine 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_membershipReferenz 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 ReferenzenKeine Filterung nach einer FractionMembership Id sinnvoll, es kann aber nach den Feldern innerhalb dieser Entität gefiltert werden.
fraction_membership -> labelDer Name der Fraktion.StringNicht 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 -> fractionDie Fraktion, bei der / die Politiker:in Mitglied ist oder war.Referenz -> FractionEs 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_fromDas Datum, zu dem die Fraktionsmitgliedschaft begann, im Format 2024-03-29. 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.DateKeine 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_untilDas Datum, zu dem die Fraktionsmitgliedschaft endete, im Format 2024-03-29. 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.DateKeine 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
NameBeschreibungDatentypFilter
current_onEin 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 / DateMögliche Werte:
  • now - (Default) Dieser Wert hat zwei mögliche Auswirkungen.
    1. Zeigt heute aktuelle Kandidaturen / Mandate
    2. bei einem gesetzem Filter parliament_period: wird nach einer vergangenen Parlamentsperiode gefiltert werden die Kandidaturen / Mandate aufgelistet, die zum Ende der Parlamentsperiode aktuell waren.
  • all - listet alle Kandidaturen / Mandate auf, auch diejenigen, die früher als die Parlamentsperiode beendet wurden, z.B. wegen eines Rücktritts von einem Mandat.
  • Ein konkretes Datum im Format 2024-03-29 - listet Kandidaturen / Mandate auf, die zu diesem Zeitpunkt aktuell waren
fraction_current_onHier kann kann festgelegt werden, dass nur diejenige Fraktionsmitgliedschaft angezeigt werden soll, die zu einem bestimmten Zeitpunkt galt.String / DateMögliche Werte:
  • now - heute aktuelle Fraktionsmitgliedschaften
  • Ein konkretes Datum im Format 2024-03-29
fractionEine Kurzform für die Filterung nach Fraktion. Es kann nach der Id oder dem Kurznamen einer Fraktion gefiltert werden.String / IntegerEine 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_listEine Kurzform für die Filterung nach Wahlliste / ElectoralList. Es kann nach der Id oder dem Namen einer Wahlliste gefiltert werden.String / IntegerEine 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.
constituencyEine Kurzform für die Filterung nach Wahlkreis / Constituency. Es kann nach der Id oder dem Namen eines Wahlkreises gefiltert werden.String / IntegerEine 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_nrEine Kurzform für die Filterung nach Wahlkreis-Nummer.IntegerEine Kurzschreibweise für "electoral_data[entity.constituency.entity.number]=123. Stattdessen kann also constituency_nr=123 genutzt werden.
politician_first_nameEine Kurzform für die Filterung nach dem Vornamen eines Politikers / einer Politikern.StringEine Kurzschreibweise für "politician[entity.first_name]=Vorname. Stattdessen kann also politician_first_name=Vorname genutzt werden.
politician_last_nameEine Kurzform für die Filterung nach dem Familiennamen eines Politikers / einer Politikern.StringEine Kurzschreibweise für "politician[entity.last_name]=Nachname. Stattdessen kann also politician_last_name=Nachname genutzt werden.
politician_partyEine 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 / StringEine 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.