Search Official Announcements
ris_search_announcementsSearch Austria’s sectoral official gazettes and executive documents — seven collections behind one collection enum: social_insurance (Amtliche Verlautbarungen der Sozialversicherung, authentic), veterinary (Amtliche Veterinärnachrichten, authentic), court_rules (Kundmachungen der Gerichte — rules of procedure and case-allocation plans, authentic; currently LVwG Tirol and Vorarlberg only), trade_exam_rules (Prüfungsordnungen gemäß Gewerbeordnung, authentic), health_structure_plans (Strukturpläne Gesundheit — federal ÖSG and per-state RSG, authentic), ministerial_decrees (Erlässe der Bundesministerien — decrees interpreting law; bind the administration, not citizens), and council_minutes (Ministerratsprotokolle — council-of-ministers session records). Each collection accepts a different filter set: query and title are broadly available; number, published_from/to, in_force_as_of, issuer (ministry and social-insurance carrier abbreviations expanded), norm ("decrees citing the DSG"), case_number, type, department, plan_type/plan_state (health plans), session_number/legislature (council minutes), and changed_since (all but social_insurance and veterinary) apply where the collection supports them — a filter outside its set is rejected locally. Every result carries a binding label, the authentic PDF where it exists, and the RIS web view (document_url) — the only browsable surface for the PDF-only council minutes and for ministerial decrees. Per-collection parameter matrix and issuers: ris_list_reference topic collections or issuing_bodies.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"collection": "<collection>"
},
"name": "ris_search_announcements"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| norm | No | Cited-provision filter (Norm) — "DSG §1", "DSGVO Art32" style. veterinary and ministerial_decrees only ("decrees citing the DSG"). An article in any spelling ("B-VG Art57", "Art. 57 B-VG") is searched under all three RIS indexes (Art57, Art 57, Artikel 57), joined by ODER, and the notice names that expression; a value carrying ( ) or " is sent as written. Omit to leave unfiltered; a blank value is rejected. | |
| page | No | 1-based result page. Default 1. | |
| type | No | Document type (Typ) — trade_exam_rules (Befaehigungspruefungsordnung | Meisterpruefungsordnung | HoehereBerufsqualifikation | Fachdiplom | HoeheresFachdiplom), court_rules (Geschaeftsordnung | Geschaeftsverteilung), veterinary (Kundmachungen | VeroeffentlichungenAufGrundVEVO | SonstigeVeroeffentlichungen). Only these values, in any letter case. Omit to leave unfiltered; a blank value is rejected. | |
| query | No | Full-text search (Suchworte). Boolean operators UND/ODER/NICHT or AND/OR/NOT, parentheses, quoted phrases; wildcard * is trailing-only. Valid for all collections. Omit to leave unfiltered; a blank value is rejected. | |
| title | No | Title search (Titel) — phrase field. Valid for all collections except council_minutes. Omit to leave unfiltered; a blank value is rejected. | |
| issuer | No | Issuing body — social_insurance (Urheber: a carrier abbreviation such as ÖGK, DVSV, SVS, BVAEB, AUVA, or PVA is expanded to its full designation; a full designation or a "<ABBR> Gesamtvertrag" series is sent as written), ministerial_decrees (Bundesministerium) or council_minutes (Einbringer) — a ministry abbreviation such as "BMF" is expanded, a full designation is sent as written. Values: ris_list_reference topic issuing_bodies or ministries. Omit to leave unfiltered; a blank value is rejected. | |
| number | No | Serial number (Avsvnummer / Avnnummer / Spgnummer) — social_insurance, veterinary, health_structure_plans. Omit to leave unfiltered; a blank value is rejected. | |
| sort_by | No | Sort column: published or number, where the collection has the column. Default: upstream order. | |
| page_size | No | Documents per page, 1–100 (default 20). Served as a page of 10 (1–10) or 20 (11–100), with a notice when that differs. For more results, keep the size and raise page. | |
| plan_type | No | health_structure_plans only. Plan kind — all (default), expert_opinion (Gutachten), or regulation (Verordnungen). Searches the federal ÖSG unless plan_state is set. | |
| collection | Yes | Which collection to search — one per call. social_insurance | veterinary | court_rules | trade_exam_rules | health_structure_plans | ministerial_decrees | council_minutes. Per-collection filter matrix: ris_list_reference topic collections. | |
| department | No | Ministry department (Abteilung) — ministerial_decrees only. Omit to leave unfiltered; a blank value is rejected. | |
| plan_state | No | health_structure_plans only. Restrict to one Bundesland’s regional health-structure plan (RSG) — setting it switches the search from the federal ÖSG to that state’s RSG. | |
| case_number | No | Business reference number (Geschäftszahl) — veterinary and ministerial_decrees only. Omit to leave unfiltered; a blank value is rejected. | |
| legislature | No | Legislative period (Gesetzgebungsperiode, e.g. "XXVII") — council_minutes only. Omit to leave unfiltered; a blank value is rejected. | |
| published_to | No | Latest publication/session date (YYYY-MM-DD). | |
| changed_since | No | Coarse recency filter — documents changed in RIS within the interval. Every collection except social_insurance and veterinary, where RIS ignores it: use published_from there, or ris_track_changes for changes. For exact windows use ris_track_changes. | |
| in_force_as_of | No | Version in force on this date (YYYY-MM-DD) — veterinary, court_rules, trade_exam_rules, health_structure_plans, ministerial_decrees (the consolidated-ish collections). RIS also returns documents with no recorded entry-into-force date, for any date; they carry no in_force_from. | |
| published_from | No | Earliest publication/session date (YYYY-MM-DD). All collections except ministerial_decrees (decrees date by force — use in_force_as_of / entered_force_from/to). | |
| session_number | No | Council session number (Sitzungsnummer) — council_minutes only. Omit to leave unfiltered; a blank value is rejected. | |
| sort_direction | No | Sort direction; applies with sort_by. | |
| entered_force_to | No | Provisions that entered force on/before this date (YYYY-MM-DD) — ministerial_decrees only. RIS also returns decrees with no recorded entry-into-force date, for any date; they carry no in_force_from. | |
| entered_force_from | No | Provisions that entered force on/after this date (YYYY-MM-DD) — ministerial_decrees only. RIS also returns decrees with no recorded entry-into-force date, for any date; they carry no in_force_from. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number RIS served. | |
| error | No | Present when the call failed. Absent on success. | |
| notice | No | The served page size when it differs from page_size; then, when norm names an article, the expression it was searched as; then, under an in-force filter, how many rows on this page have no in_force_from (RIS returns undated documents for any date); then zero-hit guidance — the likely cause and the concrete next call. A reversed window (published_from later than published_to, or entered_force_from later than entered_force_to) is answered without a RIS request: 0 documents, and the swapped bounds to retry with in place of the guidance. | |
| results | No | Matching documents for the requested page. Totals and paging in enrichment. | |
| pageSize | No | Page size RIS applied. | |
| truncated | No | Present and true when more pages exist beyond this one — raise page to continue. | |
| totalCount | No | Total matching documents across all pages. |