Schriftliche Anfragen: API-Doku

Open-Data-Schnittstelle des österreichischen Parlaments für Anfragen im Nationalrat (NR) und Bundesrat (BR).

Stand 16.11.2026Daten: CC BY 4.0OpenAPI 3.0.3

Inoffizielle Doku, erstellt aus der Datensatzbeschreibung und aus Beobachtung der Schnittstelle. Wo beides abweicht, steht die Beobachtung, mit Hinweis. Keine Garantie auf Stabilität: Rate Limits, Fehlercodes und Aktualisierungsintervall sind vom Parlament nicht dokumentiert.

Überblick

Basis-URLhttps://www.parlament.gv.at
Authentifizierungkeine
FormatJSON (UTF-8)
Abdeckungab der XX. GP (BR-Abruf ohne GP-Filter liefert zusätzlich Zeilen aus XIX und V)
AktualitätFeld lastSync in jeder Antwort. Die Zeilen tragen einen nächtlichen sysdate.
LizenzErgebnislisten und Geschichtsseiten: CC BY 4.0. Nicht freigegeben: Titel, Kurzbeschreibung, Dokumente und Volltexte, Porträts.

Endpunkte

POST/Filter/api/filter/data/101Ergebnisliste der Filtersuche

Liefert alle Anfragen, die zu den Filtern passen. Dimensionen werden mit UND verknüpft, Ausprägungen innerhalb einer Dimension mit ODER. Mit showAll=true kommt alles in einer Antwort (pages = 1).

Query-Parameter

NameWertBeschreibung
js*evalfix
showAll*truealle Treffer in einer Antwort

Request-Body (JSON)

Objekt mit Dimensionscodes als Schlüssel und Arrays von Ausprägungen als Werte.

DimensionBedeutungAusprägungen
NRBRGremiumNR, BR
GP_CODEGesetzgebungsperioderömisch, z. B. XXVIII
DATUM_VONZeitraum (Start, Ende)dd.mm.yyyy
VHGGegenstandNR: J_JPR_M · BR: J_JPR_M-BR
DOKTYPArt der Anfrage (nur NR, zusammen mit VHG)J Anfrage, JPR an Präsidium bzw. Ausschussvorsitz
VHG2Adressat-Art (BR: zusammen mit VHG)NR: JMIN, JPRPR, JRHDoku fehlt, JPRAUSDoku fehlt · BR: JMIN-BR, JPRPR-BR, M-BR (mündlich)
THEMENThemenbereich20 feste Werte (Arbeit, Außenpolitik, Bildung, Budget und Finanzen, Europäische Union, Familie und Generationen, Frauen und Gleichbehandlung, Gesundheit und Ernährung, Information und Medien, Inneres und Recht, Innovation, Technologie und Forschung, Klima, Umwelt und Energie, Kultur, Land- und Forstwirtschaft, Landesverteidigung, Parlament und Demokratie, Soziales, Sport, Verkehr und Infrastruktur, Wirtschaft)
FRAK_CODEKlub/FraktionT Stronach, F FPÖ/F-BZÖ, B BZÖ, G Grüne, V ÖVP, N NEOS/NEOS-LIF, L LIF, J JETZT, P PILZ, S SPÖ, A ohne Klub
PAD_INTERNPerson (Einbringer:in)Personen-ID aus „Parlamentarier:innen seit 1918“
INRNUM, SW, EUROVOCNummer, Schlagwort, EuroVoczu viele Werte; über die grafische Filtersuche ermitteln
Die BR-Doku nennt im Beispiel VHG2: JMIN, in der Dimensionsliste aber JMIN-BR. In den gelieferten Daten steht JMIN-BR.

Ausprobieren: Request-Body bearbeiten

Body anpassen, der curl-Befehl darunter wird live erzeugt. Die Seite darf selbst keine Abrufe machen, den Befehl also im Terminal ausführen.

Antwort 200

FeldTypBeschreibung
pagesintegerSeitenzahl (mit showAll immer 1)
lastSyncstringZeitpunkt des letzten Datensync, z. B. 2026-11-16 08:27:22.0
countintegerAnzahl Treffer
headerarray36 Spaltenbeschreibungen (rnr, label, hidden, …). Die Doku nennt 30.
rowsarray von arrayspositionsbasierte Werte in Reihenfolge von header. Einzelne Zeilen können kürzer sein.

Spalten in rows (beobachtet)

Pos.LabelInhalt
1GP_CODEGesetzgebungsperiode, römisch (BR: ebenfalls GP)
2ITYPTyp: J, JPR, J-BR, M-BR
3INRNummer (String)
4ZUKZZusatzkennzeichen, immer null
5DatumDatum, dd.mm.yyyy
6ArtArt des Gegenstands (wie DOKTYP)
7Betreff nicht Open DataTitel inkl. „beantwortet durch N/AB (Klub)“. Laut Doku nicht zur Weiterverwendung freigegeben, wird aber geliefert.
8NummerZitation, z. B. 4483/J, BR: 4265/J-BR/2024
9DATUMSORTyyyymmdd, technisch
10PHASEN_BISmögliche Phasen, z. B. 05
11Statusaktuelle Phase: 5 abgeschlossen, 3 offen (abgeleitet aus den Daten, nicht dokumentiert). 5 heißt nicht zwingend „beantwortet“ (auch Dringliche und zurückgezogene).
12DOKTYPDokumenttyp
13Zust?Zustimmung möglich, bei Anfragen immer N
14DOKTYP_LANGLangform, z. B. „Schriftliche Anfrage“
15HIS_URLrelativer Link zur Geschichtsseite, z. B. /gegenstand/XXVIII/J/4483
16RSS_DESCRSS-Beschreibung (in Beobachtung null)
17DATUM_VONDatum, ISO (Doku: null, real befüllt)
18VHGGegenstand-Code
19VHG2Adressat-Art
20LZ-ButtonsHTML (Lesezeichen), kein Open Data
21PersonenJSON-Array als String mit Personen-IDs: Einbringer (je Klub eine Person) plus Adressat
22FraktionenJSON-Array als String. Labels uneinheitlich: FPÖ und F, OK, STRONACH, NEOS-LIF u. a.; BR zusätzlich OF
23THEMENJSON-Array als String
24SWSchlagwörter, JSON-Array als String
25EUROVOCEuroVoc, JSON-Array als String
26sysdate???Zeitstempel des Syncs, technisch
27WENTRY_IDtechnische ID
28INRNUMNummer als Zahl
29NR_GP_CODEGP
30NRBRNR oder BR
31–36Gruppe, Abstimmung 3. Lesung, Dafür, Dagegen, Abstimmungstext, Abstimmungskommentarbei Anfragen leer

Beispielzeile (gekürzt)

["XXVIII","J","4483",null,"12.01.2026","J","Betreff nicht Open Data","4483/J","20260112","05","5","J","N",
 "Schriftliche Anfrage","/gegenstand/XXVIII/J/4483",null,"2026-01-12T00:00:00","J_JPR_M","JMIN",
 "<button>…</button>","[\"32506\",\"64022\"]","[\"FPÖ\"]","[\"Inneres und Recht\"]",
 "[…Schlagwörter…]","[…EuroVoc…]","Mon Nov 16 02:02:19 CET 2026",28802982,4483,"XXVIII","NR",null,null,null,null,null,null]
GET/gegenstand/{gp}/{ityp}/{inr}?json=trueDetailseite (Geschichtsseite)

Liefert die Geschichtsseite einer Anfrage als JSON: Verfahrensstufen, Beteiligte, Themen. Der Parameter json=true steht nicht in der Datensatzdoku (dort: Aufrufweg nicht dokumentiert), funktioniert aber. Den Pfad liefert HIS_URL aus der Ergebnisliste.

Parameter

NameinBeschreibung
gp*pathrömisch, z. B. XXVIII; im BR BR
ityp*pathJ, JPR, J-BR, JPR-BR, M-BR
inr*pathNummer
json*querytrue

Beispiel

curl -s 'https://www.parlament.gv.at/gegenstand/XXVIII/J/4483?json=true'
curl -s 'https://www.parlament.gv.at/gegenstand/BR/J-BR/4265?json=true'

Antwort 200: content

FeldBeschreibung
zitation, gp_code, ityp, inr, doktypIdentifikation der Anfrage
einlangenDatum des Einlangens (ISO)
updateZeitpunkt des letzten Datenupdates
deletedLöschkennzeichen
vhg_fertig, vhg_fertig_docs, processStatus-Flags (J/N)
stages[]Verfahrensstufen: date (dd.mm.yyyy), text (kann HTML-Links enthalten, z. B. „Einlangen im Nationalrat (Frist: …)“, „Schriftliche Beantwortung (…/AB)“), priority, optional fsth (Protokollstellen)
names[]Beteiligte: funktext („Eingebracht von“, „Eingebracht an“), name, frak_code, url (/person/{id}), ltext (Funktion, nur Adressat:in). Bei Rechnungshof-Anfragen weicht funktext beim Adressaten ab. portrait ist nicht Open Data.
topics, headwords, eurovocbubbles mit label und link
documentsDokumentgruppen (PDF/HTML), nicht Open Data
title, descriptionnicht Open Data
statementsstate, approvalstate, intranet, group, history_indtechnisch

Hinweise für die Nutzung

OpenAPI-Spezifikation

Maschinenlesbare Fassung zum Einfügen in editor.swagger.io oder ein anderes OpenAPI-Werkzeug.

YAMLopenapi.yamlaufklappen
openapi: 3.0.3
info:
  title: Parlament Österreich – Schriftliche Anfragen (NR & BR)
  version: "2026-11-16 (beobachtet)"
  description: |
    Inoffizielle, aus Beobachtung erstellte Beschreibung der Open-Data-Schnittstelle des
    österreichischen Parlaments für schriftliche Anfragen (Nationalrat und Bundesrat).
    Grundlage: Datensatzdokumentation auf parlament.gv.at und Abruf der Schnittstelle am 16.11.2026.
    Wo Doku und Realität abweichen, gilt hier die Beobachtung (siehe x-doku-abweichung).
    Lizenz der Daten: CC BY 4.0. Titel, Kurzbeschreibung, Dokumente/Volltexte und Porträts sind
    nicht zur Weiterverwendung freigegeben.
  license:
    name: CC BY 4.0 (Daten)
    url: https://creativecommons.org/licenses/by/4.0/deed.de
servers:
  - url: https://www.parlament.gv.at
paths:
  /Filter/api/filter/data/101:
    post:
      summary: Ergebnisliste der Filtersuche (Anfragen NR und BR)
      description: |
        Liefert alle Anfragen, die zu den Filtern passen. Dimensionen werden mit UND verknüpft,
        Ausprägungen innerhalb einer Dimension mit ODER. Mit `showAll=true` kommt alles in einer
        Antwort (`pages` = 1). Die Zeilen sind positionsbasiert, die Spaltennamen stehen in `header`.
      operationId: filterAnfragen
      parameters:
        - name: js
          in: query
          required: true
          schema: { type: string, enum: [eval] }
        - name: showAll
          in: query
          required: true
          schema: { type: boolean, enum: [true] }
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FilterBody'
            examples:
              nr_oevp_xxvi:
                summary: NR, ÖVP, XXVI. GP
                value: { GP_CODE: [XXVI], VHG: [J_JPR_M], DOKTYP: [J], FRAK_CODE: [V] }
              br_xxviii:
                summary: BR, XXVIII. GP
                value: { NRBR: [BR], GP_CODE: [XXVIII], VHG: [J_JPR_M-BR] }
      responses:
        '200':
          description: Ergebnisliste
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilterResponse'
  /gegenstand/{gp}/{ityp}/{inr}:
    get:
      summary: Detailseite (Geschichtsseite) einer Anfrage als JSON
      description: |
        Mit `?json=true` liefert die Geschichtsseite den Inhalt als JSON. Der Parameter ist in der
        Datensatzdoku nicht dokumentiert (Doku: „Aufrufweg nicht dokumentiert“), funktioniert aber.
        Für den BR lautet der Pfad `/gegenstand/BR/{ityp}/{inr}` (z. B. `/gegenstand/BR/J-BR/4265`).
      operationId: detailAnfrage
      parameters:
        - { name: gp, in: path, required: true, schema: { type: string }, description: 'Römisch (XXVIII) oder BR', example: XXVIII }
        - { name: ityp, in: path, required: true, schema: { type: string, enum: [J, JPR, J-BR, JPR-BR, M-BR] }, example: J }
        - { name: inr, in: path, required: true, schema: { type: integer }, example: 4483 }
        - { name: json, in: query, required: true, schema: { type: boolean, enum: [true] } }
      responses:
        '200':
          description: Geschichtsseite
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Geschichtsseite'
components:
  schemas:
    FilterBody:
      type: object
      description: Schlüssel sind Dimensionscodes, Werte Arrays von Ausprägungen.
      properties:
        NRBR: { type: array, items: { type: string, enum: [NR, BR] }, description: Gremium }
        GP_CODE: { type: array, items: { type: string }, description: 'Gesetzgebungsperiode, römisch (XX … XXVIII)' }
        DATUM_VON: { type: array, items: { type: string }, description: 'Zeitraum, Format dd.mm.yyyy (Start und Ende)' }
        VHG: { type: array, items: { type: string, enum: [J_JPR_M, J_JPR_M-BR] }, description: 'Gegenstand. NR: J_JPR_M, BR: J_JPR_M-BR' }
        DOKTYP: { type: array, items: { type: string, enum: [J, JPR] }, description: 'Nur NR. Zusammen mit VHG verwenden.' }
        VHG2: { type: array, items: { type: string, enum: [JMIN, JPRPR, JRH, JPRAUS, JMIN-BR, JPRPR-BR] }, description: 'Art der Anfrage (Adressat). JRH und JPRAUS sind in der Doku nicht beschrieben.' }
        THEMEN: { type: array, items: { type: string }, description: '20 feste Themenbereiche' }
        FRAK_CODE: { type: array, items: { type: string, enum: [T, F, B, G, V, N, L, J, P, S, A] }, description: 'Klub/Fraktion (Codes laut Doku)' }
        PAD_INTERN: { type: array, items: { type: string }, description: 'Personen-ID (Datensatz Parlamentarier:innen seit 1918)' }
        INRNUM: { type: array, items: { type: string }, description: Nummer der Anfrage }
        SW: { type: array, items: { type: string }, description: Schlagwort }
        EUROVOC: { type: array, items: { type: string }, description: EuroVoc-Deskriptor }
    FilterResponse:
      type: object
      properties:
        pages: { type: integer }
        lastSync: { type: string, description: 'Zeitpunkt des letzten Datensync, z. B. 2026-11-16 08:27:22.0' }
        count: { type: integer }
        header:
          type: array
          description: Spaltenbeschreibung, 36 Einträge (Doku nennt 30)
          items:
            type: object
            properties:
              feldId: { type: integer }
              rnr: { type: integer, description: Position 1 bis 36 }
              label: { type: string }
              hidden: { type: boolean }
        rows:
          type: array
          items:
            type: array
            description: Werte in der Reihenfolge von `header`; einzelne Zeilen können kürzer sein
            items: {}
    Geschichtsseite:
      type: object
      properties:
        pagetype: { type: string, enum: [geschichtsseite] }
        meta: { type: object }
        content:
          type: object
          properties:
            zitation: { type: string, example: 4483/J }
            gp_code: { type: string }
            ityp: { type: string }
            inr: { type: string }
            doktyp: { type: string }
            update: { type: string, format: date-time }
            einlangen: { type: string, format: date-time }
            deleted: { type: boolean }
            vhg_fertig: { type: string, enum: [J, N] }
            vhg_fertig_docs: { type: string, enum: [J, N] }
            process: { type: string }
            stages:
              type: array
              items:
                type: object
                properties:
                  date: { type: string, description: dd.mm.yyyy }
                  text: { type: string, description: 'Kann HTML-Links enthalten, z. B. „Einlangen im Nationalrat (Frist: …)“' }
                  priority: { type: integer }
                  fsth: { type: array, items: { type: object } }
            documents: { type: array, items: { type: object }, description: 'Nicht Open Data (Dokumente/Volltexte)' }
            names:
              type: array
              items:
                type: object
                properties:
                  funktext: { type: string, description: '„Eingebracht von“, „Eingebracht an“; bei Rechnungshof-Anfragen abweichend' }
                  name: { type: string }
                  frak_code: { type: string }
                  ltext: { type: string, description: Funktionsbezeichnung (nur Adressat:innen) }
                  url: { type: string, example: /person/64022 }
                  portrait: { type: object, description: Nicht Open Data }
            topics: { type: object, description: 'bubbles mit label und link' }
            headwords: { type: object }
            eurovoc: { type: object }