datasus_territorios: List Brazilian territories

In datasus: An Interface to Brazilian Public Health Data

List Brazilian territories

Description

Returns the package's offline territorial reference. The municipality table is generated from the official IBGE Localities API and contains current municipality, state, macroregion, immediate/intermediate region and legacy micro/mesoregion codes and names.

Usage

datasus_territorios(nivel = c("municipio", "uf", "regiao"), uf = NULL)

Arguments

nivel	Territorial level: '"municipio"', '"uf"' or '"regiao"'.
uf	Optional state selector. It accepts a two-digit IBGE code, state abbreviation or full state name. It is available for municipality and state results.

Value

A data frame. Source and extraction metadata are available through [datasus_proveniencia()].

Examples

datasus_territorios("regiao")
datasus_territorios("uf")
head(datasus_territorios("municipio", uf = "MS"))

datasus documentation built on Oct. 7, 2026, 1:07 a.m.