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.
| 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 2024-12-23. 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 2024-12-23. 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 2024-12-23. 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 2024-12-23. 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 |
| 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:
|
| fraction_current_on | Hier kann kann festgelegt werden, dass nur diejenige Fraktionsmitgliedschaft angezeigt werden soll, die zu einem bestimmten Zeitpunkt galt. | String / Date | Mögliche Werte:
|
| 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. |