# abgeordnetenwatch.de

> Follow Germany's politicians with abgeordnetenwatch.de: search the members and candidates of the Bundestag, the state parliaments and the European Parliament, see the seats they won and the elections they stood in, how each of them and each parliamentary group voted in every roll-call vote, their committees, and the side jobs and extra income Bundestag members declare. Start a workflow when a parliament holds a new roll-call vote or a new side job is declared. No account or API key required.

App · 18 actions. Web page: https://docs.lodol.com/docs/integrations/abgeordnetenwatch

## Actions

### Get a politician

Get a politician's profile by their ID: name, title, party and earlier parties, year of birth, occupation, education, where they live, how many citizens' questions they got and answered, and their Wikidata and Bundestag IDs.

**Inputs**

- Politician (`politician`, text, required): The politician's ID on abgeordnetenwatch.de. 'Search politicians' gives it.

**Outputs**

- `birth_name` (text): Name at birth, when it differs.
- `bundestag_id` (text): Their ID at the Bundestag administration, if any.
- `education` (text): Their education or qualification, in German.
- `first_name` (text): First name.
- `gender` (text): female, male or diverse, when given.
- `last_name` (text): Last name.
- `name` (text): The politician's full name.
- `occupation` (text): Their occupation, in German.
- `party` (text): The party they belong to now, such as 'SPD'.
- `party_history` (text): Notes on earlier party memberships, in German.
- `party_id` (number): The ID of the party they belong to now.
- `politician_id` (number): The politician's ID, which 'Get a politician' and the other politician actions take.
- `profile_url` (text): Their profile page on abgeordnetenwatch.de.
- `questions_answered` (number): How many of those they answered.
- `questions_received` (number): Questions citizens asked them on abgeordnetenwatch.de during a current candidacy or mandate.
- `residence` (text): Where they live.
- `title` (text): Academic title, such as 'Dr.', as the politician gave it.
- `wikidata_id` (text): Their Wikidata ID, such as 'Q567'.
- `year_of_birth` (number): Year of birth.

**Example output**

```json
{
  "birth_name": null,
  "bundestag_id": "11003231",
  "education": "Rechtsanwalt",
  "first_name": "Olaf",
  "gender": "male",
  "last_name": "Scholz",
  "name": "Olaf Scholz",
  "occupation": "MdB",
  "party": "SPD",
  "party_history": null,
  "party_id": 1,
  "politician_id": 66924,
  "profile_url": "https://www.abgeordnetenwatch.de/profile/olaf-scholz",
  "questions_answered": 2,
  "questions_received": 1170,
  "residence": "Potsdam",
  "title": null,
  "wikidata_id": "Q61053",
  "year_of_birth": 1958
}
```

### Get a roll-call vote's result

Get a roll-call vote with its result: how many members voted yes, no, abstained or did not vote, how each parliamentary group voted, whether the motion passed, the committees and topics, a summary of what was decided and links for further reading.

**Inputs**

- Roll-call vote (`poll`, text, required): The roll-call vote's ID: a vote in which each member's vote is recorded (namentliche Abstimmung). 'List roll-call votes' gives it.

**Outputs**

- `abstain` (number): Members who abstained.
- `accepted` (true/false): True when the motion was accepted.
- `by_fraction` (list): How each parliamentary group voted, the largest first.
- `committees` (list): The committees that brought it to the vote.
- `date` (text): The day of the vote.
- `intro` (text): abgeordnetenwatch.de's summary of what was decided, in German, as plain text.
- `links` (list): Further reading abgeordnetenwatch.de links to, such as the motion.
- `no` (number): Members who voted no.
- `no_show` (number): Members who did not vote.
- `parliament_period` (text): The parliament period, such as 'Bundestag 2025 - 2029'.
- `parliament_period_id` (number): The parliament period's ID, such as 161 for the Bundestag 2025 to 2029.
- `poll_id` (number): The roll-call vote's ID, which 'Get a roll-call vote's result' and 'List how members voted' take.
- `result` (text): 'accepted' or 'rejected'.
- `title` (text): What was voted on, in German.
- `topics` (list): The topics it is filed under.
- `url` (text): The vote's page on abgeordnetenwatch.de.
- `vote_count` (number): Members whose vote is recorded, including absences.
- `yes` (number): Members who voted yes.

**Example output**

```json
{
  "abstain": 0,
  "accepted": true,
  "by_fraction": [
    {
      "abstain": 0,
      "fraction": "CDU/CSU",
      "fraction_id": 421,
      "majority": "yes",
      "no": 0,
      "no_show": 0,
      "total": 2,
      "yes": 2
    },
    {
      "abstain": 0,
      "fraction": "SPD",
      "fraction_id": 425,
      "majority": null,
      "no": 0,
      "no_show": 1,
      "total": 1,
      "yes": 0
    }
  ],
  "committees": [
    {
      "committee_id": 6102,
      "name": "Ausschuss f\u00fcr Umwelt, Klimaschutz, Naturschutz und nukleare Sicherheit"
    }
  ],
  "date": "2026-10-16",
  "intro": "Der Bundestag hat der Beschlussempfehlung zugestimmt. Der CO\u2082-Preis wird 2027 nicht erh\u00f6ht.\nAngenommen mit 303 Ja-Stimmen zu 210 Nein-Stimmen bei 52 Enthaltungen.",
  "links": [
    {
      "title": "Namentliche Abstimmungen: ABC der wichtigsten Begriffe",
      "url": "https://www.abgeordnetenwatch.de/node/4907"
    }
  ],
  "no": 0,
  "no_show": 1,
  "parliament_period": "Bundestag 2025 - 2029",
  "parliament_period_id": 161,
  "poll_id": 6733,
  "result": "accepted",
  "title": "\u00c4nderung des Brennstoffemissionshandelsgesetzes (CO\u2082-Preis)",
  "topics": [
    {
      "name": "Umwelt",
      "name_english": "Environment",
      "topic_id": 9
    }
  ],
  "url": "https://www.abgeordnetenwatch.de/bundestag/21/abstimmungen/aenderung-des-brennstoffemissionshandelsgesetzes-co2-preis",
  "vote_count": 3,
  "yes": 2
}
```

### List a committee's members

List the members of a committee with each one's role: chair, vice chair, member, substitute member and the rest.

**Inputs**

- Committee (`committee`, text, required): The committee's ID. 'List committees' gives it.
- Role (`role`, text): Only members with this role. Every role by default. One of: `any` (Every role), `chairperson` (Chair), `vice_chairperson` (Vice chair), `foreperson` (Group's lead member (Obmann or Obfrau)), `spokesperson`, `alternate_spokesperson` (Deputy spokesperson), `secretary`, `alternate_secretary` (Deputy secretary), `advisory_member` (Advisory member), `eligible_member` (Member entitled to take part), and 3 more. Default: `any`.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `100`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `committee` (text): The committee's name, in German.
- `committee_id` (number): The committee's ID.
- `count` (number): How many are on this page.
- `members` (list): Each member and their role.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "committee": "Ausschuss f\u00fcr Umwelt, Klimaschutz, Naturschutz und nukleare Sicherheit",
  "committee_id": 6102,
  "count": 1,
  "members": [
    {
      "additional_roles": [],
      "mandate_id": 70561,
      "membership_id": 30001,
      "politician": "Stefan Glaser",
      "role": "member",
      "role_label": "Member"
    }
  ],
  "more_available": true,
  "page": 1,
  "total": 75
}
```

### List a politician's committees

List the committees a politician sits or sat on, with their role on each and the legislature, for every period or one.

**Inputs**

- Politician (`politician`, text, required): The politician's ID on abgeordnetenwatch.de. 'Search politicians' gives it.
- Parliament period (`parliament_period`, text): Only this legislature (a parliament's term), such as Bundestag 2025 - 2029. Leave empty for every one.

**Outputs**

- `committees` (list): Each committee they sit or sat on.
- `count` (number): How many committee memberships are listed.
- `politician` (text): The politician's full name.
- `politician_id` (number): The politician's ID, which 'Get a politician' and the other politician actions take.

**Example output**

```json
{
  "committees": [
    {
      "additional_roles": [],
      "committee": "Ausschuss f\u00fcr Umwelt, Klimaschutz, Naturschutz und nukleare Sicherheit",
      "committee_id": 6102,
      "committee_url": "https://www.abgeordnetenwatch.de/bundestag/21/ausschuesse/ausschuss-fuer-umwelt-klimaschutz-naturschutz-und-nukleare-sicherheit",
      "mandate_id": 70561,
      "membership_id": 30001,
      "parliament_period": "Bundestag 2025 - 2029",
      "role": "member",
      "role_label": "Member"
    }
  ],
  "count": 1,
  "politician": "Stefan Glaser",
  "politician_id": 182899
}
```

### List a politician's mandates and candidacies

List every seat a politician has held (a mandate) and every election they stood in (a candidacy), newest first: the parliament and period, their constituency and share of its vote, their place on the party list, how the seat was won and the parliamentary groups they sat with.

**Inputs**

- Politician (`politician`, text, required): The politician's ID on abgeordnetenwatch.de. 'Search politicians' gives it.
- Show (`entry_type`, text): Mandates, candidacies or both. One of: `all` (Mandates and candidacies), `mandate` (Mandates (seats held) only), `candidacy` (Candidacies (elections stood in) only). Default: `all`.

**Outputs**

- `candidacy_count` (number): How many are candidacies (elections stood in).
- `count` (number): How many mandates and candidacies are listed.
- `entries` (list): Each mandate and candidacy, newest first.
- `mandate_count` (number): How many of them are mandates (seats held).
- `politician` (text): The politician's full name.
- `politician_id` (number): The politician's ID, which 'Get a politician' and the other politician actions take.

**Example output**

```json
{
  "candidacy_count": 1,
  "count": 2,
  "entries": [
    {
      "constituency": "Potsdam \u2013 Potsdam-Mittelmark II \u2013 Teltow-Fl\u00e4ming II",
      "constituency_id": 13967,
      "constituency_number": 61,
      "constituency_result": 21.8,
      "constituency_votes": null,
      "electoral_list": "Landesliste Brandenburg",
      "electoral_list_id": 721,
      "end_date": null,
      "fraction": "SPD",
      "fraction_id": 425,
      "fraction_memberships": [
        {
          "fraction": "SPD",
          "fraction_id": 425,
          "valid_from": null,
          "valid_until": null
        }
      ],
      "id": 68873,
      "info": null,
      "list_position": 1,
      "parliament_period": "Bundestag 2025 - 2029",
      "parliament_period_id": 161,
      "party": null,
      "party_id": null,
      "politician": "Olaf Scholz",
      "politician_id": 66924,
      "profile_url": "https://www.abgeordnetenwatch.de/profile/olaf-scholz",
      "start_date": null,
      "type": "mandate",
      "won_by": "constituency",
      "won_by_label": "Won the constituency (a direct mandate)"
    },
    {
      "constituency": "Potsdam \u2013 Potsdam-Mittelmark II \u2013 Teltow-Fl\u00e4ming II",
      "constituency_id": 13369,
      "constituency_number": 61,
      "constituency_result": null,
      "constituency_votes": null,
      "electoral_list": "Landesliste Brandenburg",
      "electoral_list_id": 689,
      "end_date": null,
      "fraction": null,
      "fraction_id": null,
      "fraction_memberships": [],
      "id": 64889,
      "info": null,
      "list_position": 1,
      "parliament_period": "Bundestag Wahl 2025",
      "parliament_period_id": 160,
      "party": "SPD",
      "party_id": 1,
      "politician": "Olaf Scholz",
      "politician_id": 66924,
      "profile_url": "https://www.abgeordnetenwatch.de/profile/olaf-scholz",
      "start_date": null,
      "type": "candidacy",
      "won_by": null,
      "won_by_label": null
    }
  ],
  "mandate_count": 1,
  "politician": "Olaf Scholz",
  "politician_id": 66924
}
```

### List a politician's votes

List a politician's voting record, most recent first: each roll-call vote they took part in (or missed), how they voted, the vote's date and whether the motion passed. Narrow it to one legislature or one way of voting.

**Inputs**

- Politician (`politician`, text, required): The politician's ID on abgeordnetenwatch.de. 'Search politicians' gives it.
- Parliament period (`parliament_period`, text): Only this legislature (a parliament's term), such as Bundestag 2025 - 2029. Leave empty for every one.
- Vote (`vote`, text): Only members who voted this way. Every vote by default. One of: `any` (Every vote), `yes`, `no`, `abstain` (Abstained), `no_show` (Did not vote). Default: `any`.
- Results per page (`limit`, number): How many to return, from 1 to 200. From 1 to 200. Default: `50`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `politician` (text): The politician's full name.
- `politician_id` (number): The politician's ID, which 'Get a politician' and the other politician actions take.
- `total` (number): How many match in all, across every page.
- `votes` (list): Each of their votes, the most recent first.

**Example output**

```json
{
  "count": 1,
  "more_available": true,
  "page": 1,
  "politician": "Olaf Scholz",
  "politician_id": 66924,
  "total": 336,
  "votes": [
    {
      "absence_note": null,
      "absence_reason": null,
      "fraction": "SPD",
      "fraction_id": 425,
      "mandate_id": 68873,
      "parliament_period": "Bundestag 2025 - 2029",
      "poll": "\u00c4nderung des Brennstoffemissionshandelsgesetzes (CO\u2082-Preis)",
      "poll_date": "2026-10-16",
      "poll_id": 6733,
      "poll_result": "accepted",
      "poll_url": "https://www.abgeordnetenwatch.de/bundestag/21/abstimmungen/aenderung-des-brennstoffemissionshandelsgesetzes-co2-preis",
      "vote": "no_show",
      "vote_id": 682925,
      "vote_label": "Did not vote"
    }
  ]
}
```

### List committees

List parliamentary committees (Ausschüsse) with their legislature and topics, narrowed by legislature, topic or words in the name, to get the IDs that list their members and the votes they brought.

**Inputs**

- Parliament period (`parliament_period`, text): Only this legislature (a parliament's term), such as Bundestag 2025 - 2029. Leave empty for every one.
- Topic (`topic`, text): Only committees working on this topic.
- Search (`search`, text): Only committees whose name contains this, in German.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `100`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `committees` (list): The committees on this page.
- `count` (number): How many are on this page.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "committees": [
    {
      "committee_id": 6102,
      "name": "Ausschuss f\u00fcr Umwelt, Klimaschutz, Naturschutz und nukleare Sicherheit",
      "parliament_period": "Bundestag 2025 - 2029",
      "parliament_period_id": 161,
      "topics": [
        {
          "name": "Umwelt",
          "name_english": "Environment",
          "topic_id": 9
        }
      ],
      "url": "https://www.abgeordnetenwatch.de/bundestag/21/ausschuesse/ausschuss-fuer-umwelt-klimaschutz-naturschutz-und-nukleare-sicherheit"
    }
  ],
  "count": 1,
  "more_available": true,
  "page": 1,
  "total": 41
}
```

### List constituencies

List the constituencies (Wahlkreise) of a legislature or election by number, narrowed by name or number, to find the one a place belongs to and list who stood there.

**Inputs**

- Parliament period (`parliament_period`, text, required): The legislature or election, such as Bundestag 2025 - 2029.
- Search (`search`, text): Only constituencies whose name contains this.
- Number (`number`, number): Only the constituency with this number. From 1 to 10000.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `100`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `constituencies` (list): The constituencies, by number.
- `count` (number): How many are on this page.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "constituencies": [
    {
      "constituency_id": 13967,
      "label": "61 - Potsdam \u2013 Potsdam-Mittelmark II \u2013 Teltow-Fl\u00e4ming II (Bundestag 2025 - 2029)",
      "name": "Potsdam \u2013 Potsdam-Mittelmark II \u2013 Teltow-Fl\u00e4ming II",
      "number": 61
    }
  ],
  "count": 1,
  "more_available": true,
  "page": 1,
  "total": 299
}
```

### List electoral lists

List the electoral lists (party lists, such as a party's list for one state, a Landesliste) of a legislature or election, to list who was on each.

**Inputs**

- Parliament period (`parliament_period`, text, required): The legislature or election, such as Bundestag Wahl 2025.
- Search (`search`, text): Only lists whose name contains this.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `100`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `electoral_lists` (list): The electoral lists.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "count": 1,
  "electoral_lists": [
    {
      "electoral_list_id": 721,
      "label": "Landesliste Brandenburg (Bundestag 2025 - 2029)",
      "name": "Landesliste Brandenburg",
      "parliament_period": "Bundestag 2025 - 2029",
      "parliament_period_id": 161
    }
  ],
  "more_available": true,
  "page": 1,
  "total": 16
}
```

### List how members voted

List how each member voted in a roll-call vote (yes, no, abstained or did not vote, with the reason when given) and their parliamentary group. Narrow it to one way of voting, one group or part of a name, such as to find how your own MP voted.

**Inputs**

- Roll-call vote (`poll`, text, required): The roll-call vote's ID: a vote in which each member's vote is recorded (namentliche Abstimmung). 'List roll-call votes' gives it.
- Vote (`vote`, text): Only members who voted this way. Every vote by default. One of: `any` (Every vote), `yes`, `no`, `abstain` (Abstained), `no_show` (Did not vote). Default: `any`.
- Parliamentary group (`fraction`, text): Only members of this parliamentary group (Fraktion). Pick the group of the vote's legislature.
- Name (`name`, text): Only members whose name contains this.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `1000`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `poll` (text): What was voted on, in German.
- `poll_id` (number): The roll-call vote's ID, which 'Get a roll-call vote's result' and 'List how members voted' take.
- `total` (number): How many match in all, across every page.
- `votes` (list): Each member's vote.

**Example output**

```json
{
  "count": 3,
  "more_available": true,
  "page": 1,
  "poll": "\u00c4nderung des Brennstoffemissionshandelsgesetzes (CO\u2082-Preis)",
  "poll_id": 6733,
  "total": 630,
  "votes": [
    {
      "absence_note": null,
      "absence_reason": null,
      "fraction": "SPD",
      "fraction_id": 425,
      "mandate_id": 68873,
      "politician": "Olaf Scholz",
      "vote": "no_show",
      "vote_id": 682925,
      "vote_label": "Did not vote"
    },
    {
      "absence_note": null,
      "absence_reason": null,
      "fraction": "CDU/CSU",
      "fraction_id": 421,
      "mandate_id": 68921,
      "politician": "Katja Strauss-K\u00f6ster",
      "vote": "yes",
      "vote_id": 682800,
      "vote_label": "Yes"
    },
    {
      "absence_note": null,
      "absence_reason": null,
      "fraction": "CDU/CSU",
      "fraction_id": 421,
      "mandate_id": 70561,
      "politician": "Stefan Glaser",
      "vote": "yes",
      "vote_id": 682601,
      "vote_label": "Yes"
    }
  ]
}
```

### List parliament members or candidates

List the members of a parliament in one legislature, or the candidates in one election, with each one's parliamentary group, constituency and result, list place and how they won their seat. Narrow it to a group, a party, a constituency, an electoral list, how the seat was won or part of a name.

**Inputs**

- Parliament period (`parliament_period`, text, required): The legislature (to list its members) or election (to list its candidates), such as Bundestag 2025 - 2029.
- Parliamentary group (`fraction`, text): Only members of this parliamentary group (Fraktion), for a legislature.
- Party (`party`, text): Only politicians who belong to this party now.
- Constituency (`constituency`, text): Only those who stood in this constituency (Wahlkreis), whether or not they won it.
- Electoral list (`electoral_list`, text): Only those on this party list, such as a state list (Landesliste).
- Seat won by (`won_by`, text): Only seats won this way. One of: `any` (Any way), `constituency` (Won the constituency (a direct mandate)), `list` (Elected from the party list), `moved_up` (Moved up to fill a vacant seat). Default: `any`.
- Name (`name`, text): Only politicians whose name contains this.
- Include former members (`include_former`, true/false): Also list those who left during the period, such as members who stepped down. Off lists those holding the seat now, or at the end of a past period. Default: `false`.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `100`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `members` (list): The members (for a legislature) or candidates (for an election).
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `parliament_period` (text): The parliament period, such as 'Bundestag 2025 - 2029'.
- `parliament_period_id` (number): The parliament period's ID, such as 161 for the Bundestag 2025 to 2029.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "count": 1,
  "members": [
    {
      "constituency": "Potsdam \u2013 Potsdam-Mittelmark II \u2013 Teltow-Fl\u00e4ming II",
      "constituency_id": 13967,
      "constituency_number": 61,
      "constituency_result": 21.8,
      "constituency_votes": null,
      "electoral_list": "Landesliste Brandenburg",
      "electoral_list_id": 721,
      "end_date": null,
      "fraction": "SPD",
      "fraction_id": 425,
      "fraction_memberships": [
        {
          "fraction": "SPD",
          "fraction_id": 425,
          "valid_from": null,
          "valid_until": null
        }
      ],
      "id": 68873,
      "info": null,
      "list_position": 1,
      "parliament_period": "Bundestag 2025 - 2029",
      "parliament_period_id": 161,
      "party": null,
      "party_id": null,
      "politician": "Olaf Scholz",
      "politician_id": 66924,
      "profile_url": "https://www.abgeordnetenwatch.de/profile/olaf-scholz",
      "start_date": null,
      "type": "mandate",
      "won_by": "constituency",
      "won_by_label": "Won the constituency (a direct mandate)"
    }
  ],
  "more_available": true,
  "page": 1,
  "parliament_period": "Bundestag 2025 - 2029",
  "parliament_period_id": 161,
  "total": 120
}
```

### List parliament periods

List the legislatures (a parliament's terms) and elections abgeordnetenwatch.de covers, newest first, with their dates and IDs, for one parliament or all of them.

**Inputs**

- Parliament (`parliament`, text): Only this parliament's periods. Leave empty for all.
- Kind (`period_type`, text): Legislatures, elections or both. One of: `any` (Legislatures and elections), `legislature` (Legislatures (terms of parliament) only), `election` (Elections only). Default: `any`.

**Outputs**

- `count` (number): How many periods are listed.
- `parliament_periods` (list): Each legislature and election, newest first.

**Example output**

```json
{
  "count": 1,
  "parliament_periods": [
    {
      "election_date": null,
      "end_date": "2029-02-22",
      "name": "Bundestag 2025 - 2029",
      "parliament": "Bundestag",
      "parliament_id": 5,
      "parliament_period_id": 161,
      "previous_period": "Bundestag Wahl 2025",
      "previous_period_id": 160,
      "start_date": "2025-03-25",
      "type": "legislature",
      "url": "https://www.abgeordnetenwatch.de/bundestag"
    }
  ]
}
```

### List parliamentary groups

List parliamentary groups (Fraktionen: the group a party's members form in one parliament, for one legislature), newest first, with their IDs, for one legislature or all of them.

**Inputs**

- Parliament period (`parliament_period`, text): Only this legislature (a parliament's term), such as Bundestag 2025 - 2029. Leave empty for every one.
- Search (`search`, text): Only groups whose name contains this.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `100`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `fractions` (list): The parliamentary groups, newest first.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "count": 1,
  "fractions": [
    {
      "fraction_id": 425,
      "full_name": "SPD",
      "label": "SPD (Bundestag 2025 - 2029)",
      "name": "SPD",
      "parliament_period": "Bundestag 2025 - 2029",
      "parliament_period_id": 161
    }
  ],
  "more_available": true,
  "page": 1,
  "total": 6
}
```

### List parliaments

List the parliaments abgeordnetenwatch.de follows (the Bundestag, the 16 state parliaments and the European Parliament) with the period each is in now, to get the IDs the other actions take.

**Inputs**: None.

**Outputs**

- `count` (number): How many parliaments there are.
- `parliaments` (list): Each parliament, the Bundestag first.

**Example output**

```json
{
  "count": 2,
  "parliaments": [
    {
      "current_period": "Bundestag 2025 - 2029",
      "current_period_id": 161,
      "full_name": "Bundestag",
      "name": "Bundestag",
      "name_english": "Bundestag (federal parliament)",
      "parliament_id": 5,
      "url": "https://www.abgeordnetenwatch.de/bundestag"
    },
    {
      "current_period": "Bayern 2023 - 2028",
      "current_period_id": 149,
      "full_name": "Bayerischer Landtag",
      "name": "Bayern",
      "name_english": "Bayern (state parliament)",
      "parliament_id": 13,
      "url": "https://www.abgeordnetenwatch.de/bayern"
    }
  ]
}
```

### List parties

List the political parties abgeordnetenwatch.de records, A to Z, with their IDs, narrowed by words in the name.

**Inputs**

- Search (`search`, text): Only parties whose name contains this.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `100`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `parties` (list): The parties, A to Z.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "count": 1,
  "more_available": true,
  "page": 1,
  "parties": [
    {
      "full_name": "B\u00dcNDNIS 90/DIE GR\u00dcNEN",
      "name": "B\u00dcNDNIS 90/DIE GR\u00dcNEN",
      "party_id": 4,
      "short_name": "B\u00dcNDNIS 90/DIE GR\u00dcNEN"
    }
  ],
  "total": 212
}
```

### List roll-call votes

List roll-call votes (namentliche Abstimmungen, where each member's vote is recorded), newest first, with what was decided, the result, topics, the committee behind it and a summary. Narrow by parliament, legislature, topic, committee, result, date or words in the title.

**Inputs**

- Parliament (`parliament`, text): Only this parliament's votes. Leave empty for all.
- Parliament period (`parliament_period`, text): Only this legislature (a parliament's term), such as Bundestag 2025 - 2029. Leave empty for every one.
- Topic (`topic`, text): Only votes on this topic.
- Committee (`committee`, text): Only votes this committee brought. 'List committees' gives its ID.
- Result (`result`, text): Only accepted or only rejected motions. One of: `any` (Accepted or rejected), `accepted`, `rejected`. Default: `any`.
- Voted on or after (`date_from`, date): Only votes held on this day or later.
- Voted on or before (`date_to`, date): Only votes held on this day or earlier.
- Search (`search`, text): Only votes whose title contains this, in German.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `50`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `polls` (list): The roll-call votes, newest first.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "count": 1,
  "more_available": true,
  "page": 1,
  "polls": [
    {
      "accepted": true,
      "committees": [
        {
          "committee_id": 6102,
          "name": "Ausschuss f\u00fcr Umwelt, Klimaschutz, Naturschutz und nukleare Sicherheit"
        }
      ],
      "date": "2026-10-16",
      "intro": "Der Bundestag hat der Beschlussempfehlung zugestimmt. Der CO\u2082-Preis wird 2027 nicht erh\u00f6ht.\nAngenommen mit 303 Ja-Stimmen zu 210 Nein-Stimmen bei 52 Enthaltungen.",
      "links": [
        {
          "title": "Namentliche Abstimmungen: ABC der wichtigsten Begriffe",
          "url": "https://www.abgeordnetenwatch.de/node/4907"
        }
      ],
      "parliament_period": "Bundestag 2025 - 2029",
      "parliament_period_id": 161,
      "poll_id": 6733,
      "result": "accepted",
      "title": "\u00c4nderung des Brennstoffemissionshandelsgesetzes (CO\u2082-Preis)",
      "topics": [
        {
          "name": "Umwelt",
          "name_english": "Environment",
          "topic_id": 9
        }
      ],
      "url": "https://www.abgeordnetenwatch.de/bundestag/21/abstimmungen/aenderung-des-brennstoffemissionshandelsgesetzes-co2-preis"
    }
  ],
  "total": 85
}
```

### List side jobs

List the side jobs (Nebentätigkeiten) Bundestag members declared, newest first: the job, the organization, its category and the income where published. Narrow by politician, party, legislature, category, organization, topic or the date it was declared. Only Bundestag members' side jobs are recorded.

**Inputs**

- Politician (`politician`, text): Only this politician's side jobs, by their ID. 'Search politicians' gives it.
- Party (`party`, text): Only side jobs of politicians who belong to this party now.
- Parliament period (`parliament_period`, text): Only side jobs declared during this Bundestag legislature. Leave empty for every one.
- Category (`category`, text): Only side jobs in this category of the Bundestag's rules. One of: `any` (Any category), `29647` (Paid work alongside the mandate), `29228` (Roles in companies), `29229` (Roles in public bodies and institutions), `29230` (Roles in associations, federations and foundations), `29231` (Shares in companies or partnerships), `29232` (Donations and gifts for political work), `29233` (Agreements on future work or benefits), `29234` (Work before joining the Bundestag). Default: `any`.
- Organization (`organization`, text): Only side jobs for an organization whose name contains this.
- Topic (`topic`, text): Only side jobs filed under this topic.
- Declared on or after (`declared_after`, date): Only side jobs abgeordnetenwatch.de recorded on this day or later, to find new ones on a schedule.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `50`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `side_jobs` (list): The side jobs, newest first.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "count": 1,
  "more_available": true,
  "page": 1,
  "side_jobs": [
    {
      "category": "29647",
      "category_label": "Paid work alongside the mandate",
      "city": "Berlin",
      "country": "Deutschland",
      "declared_at": "2026-10-22T07:18:35Z",
      "details": "Brutto",
      "income": 5814.8,
      "income_interval": "monthly",
      "income_level": "\u20ac3,500 to \u20ac7,000",
      "income_total": null,
      "income_total_date": null,
      "job_title": "Stellv. Generalsekret\u00e4r (ab 21.09.2026)",
      "job_title_extra": "Einkommen ab 01.11.2026",
      "last_changed": "2026-10-22",
      "mandate_ids": [
        68990
      ],
      "organization": "CDU Deutschlands",
      "organization_id": 3412,
      "politicians": [
        "Tilman Kuban"
      ],
      "side_job_id": 21590,
      "topics": [
        {
          "name": "Politisches Leben, Parteien",
          "name_english": "Political life and parties",
          "topic_id": 27
        }
      ]
    }
  ],
  "total": 4680
}
```

### Search politicians

Find politicians in Germany's parliaments and elections by part of their name, their party, gender and year of birth: members and candidates of the Bundestag, the state parliaments and the European Parliament. Each comes with their ID, party, occupation, education, how many citizens' questions they answered and their profile link.

**Inputs**

- Name (`name`, text): Part of the politician's full name, such as a last name. Leave empty to browse by the other fields.
- Party (`party`, text): Only members of this party now. Leave empty for every party.
- Gender (`gender`, text): Only politicians of this gender. One of: `any` (Any gender), `f` (Female), `m` (Male), `d` (Diverse). Default: `any`.
- Born in or after (`born_from`, number): Only politicians born in this year or later. From 1900 to 2100.
- Born in or before (`born_to`, number): Only politicians born in this year or earlier. From 1900 to 2100.
- Sort by (`sort`, text): Last name A to Z, or the newest profiles first. One of: `last_name` (Last name, A to Z), `newest` (Newest profiles first). Default: `last_name`.
- Results per page (`limit`, number): How many to return, from 1 to 1,000. From 1 to 1000. Default: `50`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many are on this page.
- `more_available` (true/false): True when a later page has more.
- `page` (number): Which page this is, from 1.
- `politicians` (list): The politicians on this page.
- `total` (number): How many match in all, across every page.

**Example output**

```json
{
  "count": 1,
  "more_available": true,
  "page": 1,
  "politicians": [
    {
      "birth_name": null,
      "bundestag_id": "11003231",
      "education": "Rechtsanwalt",
      "first_name": "Olaf",
      "gender": "male",
      "last_name": "Scholz",
      "name": "Olaf Scholz",
      "occupation": "MdB",
      "party": "SPD",
      "party_history": null,
      "party_id": 1,
      "politician_id": 66924,
      "profile_url": "https://www.abgeordnetenwatch.de/profile/olaf-scholz",
      "questions_answered": 2,
      "questions_received": 1170,
      "residence": "Potsdam",
      "title": null,
      "wikidata_id": "Q61053",
      "year_of_birth": 1958
    }
  ],
  "total": 37
}
```
