# schwur.ch

> Swiss politics made traceable.

schwur.ch covers federal ballot proposals, parliament businesses and votes, the members of both councils, the federal administration, federal finances and subsidies, the cantons and municipalities, and news. Every figure is traceable to its source. Content is available in German, French, Italian, English and Ukrainian; German is the reference, and translations are marked as such.

## Search API

- [Search](https://schwur.ch/api/v1/search?q=AHV): `GET /api/v1/search` with `q` (up to 200 characters), `lang` (de, fr, it, en, uk; default de), `kind` (repeatable, see kinds) or `group` (proposals, parliament, federal, news, places), `limit` (up to 50) and `cursor` (the `next_cursor` of the previous answer). Each hit has a title, snippet, page `url`, JSON `api_url`, date, `origin` of its language and `source`.
- [Suggestions](https://schwur.ch/api/v1/search/suggest?q=wermu): `GET /api/v1/search/suggest` - up to 8 titles from 2 characters on.
- [Kinds](https://schwur.ch/api/v1/search/kinds): `GET /api/v1/search/kinds` - every kind of hit, with its name and a description.
- [OpenAPI](https://schwur.ch/api/v1/openapi.json): the full description of the API.
- MCP server: `https://schwur.ch/mcp` (Streamable HTTP, tools `search` and `fetch`)

## How to cite

Reuse is free, provided schwur.ch and the original source are named.

- Link every statement to the hit's `url`.
- Name schwur.ch and the original publisher given in the hit's `source`.
- A hit's `origin` says whether its text is the original, an official translation, a translation made for schwur.ch (`translated`) or the German original shown for lack of a translation (`german`). Say so when quoting a translation.

## Limits

- 60 search requests per minute per client; beyond that, 429 with `Retry-After`.
- Please cache answers. The index is rebuilt every two hours; each answer says when (`index_built_at`).

## Not available

- The register of interests and access badges: visible to signed-in accounts only, never in the search or the API's public answers.
- Discussion posts.
- Editors' drafts and withheld items.
- Opinion summaries of the podcast «Bern einfach»: title and link only.

## Pages

- [Ballot proposals](https://schwur.ch/vorlagen): federal proposals, their impacts and the evidence behind them
- [Vote calendar](https://schwur.ch/abstimmungen): federal voting days and what comes to the vote on them
- [Parliament](https://schwur.ch/parlament): the councils and their members
- [Parliament businesses](https://schwur.ch/parlament/geschaefte): every business, its course and its votes
- [Federal Council](https://schwur.ch/bundesrat): the government and its tasks
- [Confederation](https://schwur.ch/bund): federal administration, offices, finances and subsidies
- [People and organisations](https://schwur.ch/bund/personen): people, organisations and bodies in public office
- [Federal finances](https://schwur.ch/bund/finanzen): the federal accounts, as published
- [Cantons](https://schwur.ch/kantone): the 26 cantons
- [Municipalities](https://schwur.ch/gemeinden): every Swiss municipality
- [News](https://schwur.ch/news): news from parliament and the federal administration
- [Topics](https://schwur.ch/themen): proposals by topic
- [About](https://schwur.ch/ueber): how schwur.ch works
- [Data and interfaces](https://schwur.ch/daten): the MCP server, the search API and the terms of reuse
- [Terms](https://schwur.ch/regeln): terms of use