buriedsignals/anomaly/openparldata-parliamentary-data

Current catalogue release status

meta.yaml is authoritative. Execute only operations listed as Released below; other sections in this playbook may document provider or unreleased adapter scope.

Released

• ch/openparldata/parliamentary-data:search-persons — Search Persons using the fields returned by the current OpenParlData.ch — Swiss Parliamentary Data adapter.
• ch/openparldata/parliamentary-data:parl-members — One row per person OpenParlData lists for the body, current and former, with constituency, party and active flag.
• ch/openparldata/parliamentary-data:parl-affiliations — One span per run of votes a member cast under one parliamentary group label in the date window; OpenParlData publishes no dated group memberships.
• ch/openparldata/parliamentary-data:parl-votings — One row per recorded voting of the body in the date window, with its chamber, date, title and affair.
• ch/openparldata/parliamentary-data:parl-member-votes — One row per member vote in the body's votings inside the date window, read from the votes export and dated by its voting; stops at max_rows.
• ch/openparldata/parliamentary-data:parl-interests — One row per declared interest of the body's members, with organisation, role and whether the mandate is paid or honorary.

Not released

• ch/openparldata/parliamentary-data:search-affairs — Operation-level fixture coverage is not available; this operation is not released yet.
• ch/openparldata/parliamentary-data:list-person-interests — Operation-level fixture coverage is not available; this operation is not released yet.

<!-- END GENERATED OPERATION STATUS -->

Data catalogue — OpenParlData.ch

Purpose and routing

OpenParlData.ch harmonizes federal, cantonal, and municipal Swiss parliamentary data. One registry-loaded skill routes two related domains inside one adapter:

The adapter infers persons from name/person_id and affairs from q or affair_id. Set resource explicitly for every other table. This is a single portable multi-operation skill, matching Data catalogue's OpenSanctions pattern; there are no runtime sub-skills to fetch.

Auth and licence

No key. Data is CC BY 4.0. Preserve the returned attribution: Source: OpenParlData.ch.

Invocation

# People
catalogue query ch/openparldata/parliamentary-data --input '{"name":"Müller","filters":{"active":true},"limit":5}'
 
# Affairs (q defaults to the affairs resource)
catalogue query ch/openparldata/parliamentary-data --input '{"q":"Klima","search_mode":"natural","language":"de","filters":{"body_key":"CHE"},"limit":5}'
 
# Relation traversal: declared interests for a known person
catalogue query ch/openparldata/parliamentary-data --input '{"resource":"persons","id":123,"relation":"interests","limit":20}'
 
# Individual votes in a known voting
catalogue query ch/openparldata/parliamentary-data --input '{"resource":"votings","id":105037,"relation":"votes","limit":100}'

Add --out results.json (or .csv) for a file plus a compact summary.

Inputs

Output

Every record includes resource, id, and source_url, plus useful resource-specific fields. People include party, role, district and active status; affairs include title, type and status; roll calls include counts or the individual member's vote. include_raw: true retains every upstream field.

Gotchas

• Coverage differs sharply by parliament. A null field generally means that

the originating body did not publish it, not that the fact does not exist.

• partial is substring search. Use natural for multi-word concepts and

boolean for explicit &, |, !, and <-> operators.

• Search language and output language are separate. Set search_language when

precision matters; keep language_fallback for sparse translations.

• Deep pagination stops at offset 100,000. Full-table work belongs in the

gzipped NDJSON exports at <https://files.openparldata.ch/exports/>.

• A vote is evidence of one recorded division. Inspect the related affair,

voting meaning, corrections, and source link before characterizing it.

Parliamentary contract rows

The parl-* operations read the gzipped NDJSON exports at <https://files.openparldata.ch/exports/> (the API stops at offset 100,000 and a vote row carries no date) and return rows of domains/parliamentary.yaml for one body (body_key, default CHE), ready for anomaly.oneshot:

catalogue query ch/openparldata/parliamentary-data --operation parl-member-votes \
  --input '{"from":"2025-09-08","to":"2025-09-26"}'
catalogue query ch/openparldata/parliamentary-data --operation parl-interests --input '{}'

The votes export (287 MB on 2026-10-27, all bodies mixed, not in date order) is streamed once per call; a full pass took about 18 s here. Votes are kept when their voting is in the window, until max_rows.

Coverage checked on 2026-10-27: CHE Nationalrat votings run from 2003-12-01 to 2025-09-26 and Ständerat votings from 2022-02-28 to 2026-06-19, so recent Nationalrat sessions are missing. The interests export holds the current register (2,433 CHE lines: 1,078 paid, 1,355 honorary), including lines of 20 people no longer active.

Source-local helper

Run the maintained live probes from data/:

uv run python skills/ch/openparldata-parliamentary-data/scripts/smoke_queries.py

API documentation: <https://api.openparldata.ch/documentation>