Skip to contents

Get Participation Data from Austrian Parliament

Source: R/get_participation.R
get_participation.Rd

This function retrieves participation data from the Austrian Parliament's API based on various filter criteria. For the pertaining website by the Austrian Parliament see here.
Once a legislative initiative, citizens' initiative, or petition has been submitted to Parliament, pertaining statements expressing the author's opinion regarding the pending issue can be submitted. This allows the author to express his/her opinion and participate in the parliamentary process. For ministerial drafts, statements can be submitted during the pre-parliamentary process. Furthermore, statements of other authors can be supported.

Usage

get_participation(
  topic = NULL,
  legis_period = NULL,
  active = NULL,
  item = NULL,
  initiative_type = NULL,
  statement_type = NULL
)

Arguments

topic

(Themen) Character vector. Optional. Specifies the topic(s) of interest. See details for valid values.

legis_period

(Gesetzgebungsperiode) Character vector. Optional. Specifies the legislative period(s).

active

(Aktuelle Beteiligung) Character. Optional. If "J", only includes current participations.

item

(Gegenstand) Character vector. Optional. Specifies the type of review. See details for valid values.

initiative_type

(Art der Gesetzesinitiative) Optional character vector. Only if item="RGES" (Gesetzesinitiativen/Legislative Initiatives). Specifies the type of legislative initiative. See details for valid values.

statement_type

(Art der Stellungnahme) Optional character vector. Only if item="SN" (Stellungnahmen/Statements). Specifies the type of statement. See details for valid values.

Value

A tibble containing the participation data with the following columns:

  • legis_period: Legislative period

  • date: Date of the participation item (Date class)

  • active: Indicates if current participation is possible

  • item_id: Item identifier

  • item_code: Item type code

  • item: Description of the item type

  • title: Title of the participation item

  • type_doc: Document type

  • topic: Topic(s) associated with the item

  • item_url: URL to the item on the Parliament website

  • statements: Number of statements submitted

  • support: Number of supporters

  • ministry: Responsible ministry

Returns NULL if no results are found for the provided search criteria.

Details

This function sends a request to the Austrian Parliament's API to retrieve participation data based on the provided filter criteria. It performs input validation for each parameter and constructs the API request accordingly.

Valid values for topic:

  • "Arbeit" (Labor)

  • "Außenpolitik" (Foreign Policy)

  • "Bildung" (Education)

  • "Budget und Finanzen" (Budget and Finance)

  • "Europäische Union" (European Union)

  • "Familie und Generationen" (Family and Generations)

  • "Frauen und Gleichbehandlung" (Women and Equal Treatment)

  • "Gesundheit und Ernährung" (Health and Nutrition)

  • "Information und Medien" (Information and Media)

  • "Inneres und Recht" (Interior and Justice)

  • "Innovation, Technologie und Forschung" (Innovation, Technology and Research)

  • "Klima, Umwelt und Energie" (Climate, Environment and Energy)

  • "Kultur" (Culture)

  • "Land- und Forstwirtschaft" (Agriculture and Forestry)

  • "Landesverteidigung" (National Defense)

  • "Parlament und Demokratie" (Parliament and Democracy)

  • "Soziales" (Social Affairs)

  • "Sport" (Sports)

  • "Verkehr und Infrastruktur" (Transport and Infrastructure)

  • "Wirtschaft" (Economy)

Setting topic = NULL returns values for all topics listed above.

Valid values for item:

  • "RGES" (Gesetzesinitiativen / Legislative Initiatives)

  • "ME" (Ministerialentwürfe / Ministerial Drafts)

  • "BI" (Bürgerinitiativen / Citizens' Initiatives)

  • "PET" (Petitionen / Petitions)

  • "SN" (Stellungnahmen / Statements) Setting item = NULL returns values for all review types listed above.

Valid values for initiative_type (Only if item=="RGES"):

  • "A" (Gesetzesanträge von Abgeordneten / Legislative Motions by Members)

  • "BUA" (Gesetzesanträge von Ausschüssen / Legislative Motions by Committees)

  • "RV" (Regierungsvorlagen / Government Bills)

Setting initiative_type = NULL returns values for all initiative types listed above.

Valid values for statement_type (Only if item=="SN"):

  • "SNME" (Stellungnahme Ministerialentwurf / Statement on Ministerial Draft)

  • "SN" (Stellungnahme Gesetzesinitiative / Statement on Legislative Initiative)

  • "SPET" (Stellungnahme zur Petition / Statement on Petition)

  • "SPET-BR" (Stellungnahme zur Petition Bundesrat / Statement on Petition Federal Council)

  • "SBI" (Stellungnahme Bürgerinitiative / Statement on Citizens' Initiative)

Setting statement_type = NULL returns values for all statement types listed above.

Examples

if (FALSE) { # \dontrun{
# Get participation data for the topic "Bildung"
get_participation(topic = "Bildung")

# Get participation data for multiple topics and legislative periods
get_participation(
  topic = c("Arbeit", "Soziales"),
  legis_period = c("27", "26"),
  item = "RGES"
)

# Get participation data on all ministerial drafts for legislative periods 26 and 27
get_participation(
  legis_period = c(26, 27),
  item = "ME"
)

# Get participation data on legislative initiatives with specific initiative type
get_participation(
  item = "RGES",
  initiative_type = "RV"
)
} # }