get_projects: Retrieve infrastructure projects

In obrasgovr: Access the 'ObrasGov' Open Data API

Retrieve infrastructure projects

Description

Retrieves infrastructure projects and their nested relationships, including executors, recipients, funding sources, policy areas, and point geometries.

Usage

get_projects(
  ...,
  page = 1L,
  page_size = 50L,
  all_pages = FALSE,
  page_limit = Inf,
  base_url = .obrasgovr_base_url()
)

obter_projetos(
  ...,
  pagina = 1L,
  tamanho_da_pagina = 50L,
  todas_paginas = FALSE,
  limite_paginas = Inf,
  base_url = .obrasgovr_base_url()
)

Arguments

...	Named filters accepted by the resource. See the complete list with list_filters("projects"). Filter names and categorical values are kept in Portuguese because they are defined by the ObrasGov API.
page	First page to retrieve, starting at 1.
page_size	Number of records per page, between 1 and 200.
all_pages	If TRUE, retrieves successive pages starting at page.
page_limit	Maximum number of pages to retrieve when all_pages is TRUE. Use Inf to retrieve every available page.
base_url	HTTPS base URL. By default, uses the obrasgovr.base_url option or the official API environment.
pagina, tamanho_da_pagina, todas_paginas, limite_paginas	Portuguese aliases for page, page_size, all_pages, and page_limit, respectively. These arguments are available only in the Portuguese function alias.

Value

A tibble. One-to-many relationships are preserved in list-columns. Use result_metadata() to inspect pagination information.

See Also

Other API resources: get_commitments(), get_contracts(), get_feasibility_studies(), get_geometries(), get_last_update(), get_physical_execution(), get_status_history()

Examples

if (interactive()) {
  get_projects(uf_principal = "PE", page_size = 10)
}

obrasgovr documentation built on July 24, 2026, 5:07 p.m.