get_siope_despesas_funcao: Get SIOPE expenses by education function

In tesouror: Access Brazilian National Treasury Open Data APIs

Get SIOPE expenses by education function

Description

Retrieves education expenses broken down by government function (e.g., basic education, higher education).

Usage

get_siope_despesas_funcao(
  ano,
  periodo,
  uf,
  use_cache = TRUE,
  verbose = FALSE,
  page_size = 1000L,
  max_rows = Inf,
  filter = NULL,
  orderby = NULL,
  select = NULL
)

get_siope_expenses_by_function(year, period, state,
  use_cache = TRUE, verbose = FALSE,
  page_size = 1000, max_rows = Inf,
  filter = NULL, orderby = NULL, select = NULL)

Arguments

ano	Integer. Year of the data (e.g., 2023). Required.
periodo	Integer. Bimester period (1-6). Required.
uf	Character. State abbreviation (e.g., "PE"). Required.
use_cache	Logical. If TRUE (default), uses an in-memory cache.
verbose	Logical. If TRUE, prints the full API URL. Defaults to FALSE. Set globally with options(tesouror.verbose = TRUE).
page_size	Integer. Rows per page for OData pagination. Defaults to 1000.
max_rows	Numeric. Maximum rows to return. Defaults to Inf.
filter	Character. OData ⁠$filter⁠ expression to narrow results on the server (much faster than downloading everything). Uses OData syntax (e.g., "NOM_MUNI eq 'Recife'", "COD_MUNI eq 2611606"). Combine with and/or. Column names must use the original API names (uppercase), not the snake_case cleaned names. To discover valid names, run a max_rows = 1 query and use toupper(names(result)). Optional.
orderby	Character. OData ⁠$orderby⁠ expression to sort results (e.g., "NOM_MUNI asc", "NUM_POPU desc"). Uses original API column names (uppercase). Optional.
select	Character vector. Column names to return (reduces payload size). Uses original API column names (e.g., c("NOM_MUNI", "VAL_DECL")). If a column name is invalid the API returns HTTP 400. Optional.
year	Integer. Year. Required. Maps to ano.
period	Integer. Bimester (1-6). Required. Maps to periodo.
state	Character. State abbreviation. Required. Maps to uf.

Details

get_siope_expenses_by_function() is an English alias.

Value

A tibble with 12 columns including function codes and expense values.

See Also

Other SIOPE: get_siope_dados_gerais(), get_siope_despesas(), get_siope_indicadores(), get_siope_info_complementares(), get_siope_receitas(), get_siope_remuneracao(), get_siope_responsaveis()

Examples

## Not run: 
desp_func <- get_siope_despesas_funcao(ano = 2023, periodo = 6, uf = "PE")

## End(Not run)

tesouror documentation built on May 7, 2026, 1:06 a.m.