Reference · built on requestCommons signalPlaces & geographic reference

IBGE Localidades API

Brazilian administrative divisions, macroregions, states, municipalities, and district codes from IBGE.

Request accessPricing ↗

About

The IBGE Localidades API is a public data service provided by the Instituto Brasileiro de Geografia e Estatística (IBGE), Brazil's national statistical and geographic agency. The API provides programmatic access to the standard political-administrative division of Brazil, detailing macroregions, federative units (states), intermediate geographic regions, immediate geographic regions, municipalities, and municipal districts with canonical IBGE numerical identifiers.

Through Fibric, an operator references standardized IBGE municipality and state codes to align Brazilian sales territories, assign regional tax regimens, and cross-reference demographic metrics against geographic delivery routes without manual classification overhead.

This is a reference listing. It documents what Fibric would read from IBGE Localidades API and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Brazilian macroregions and federative units (states) with standard IBGE two-digit state codes
  • Municipalities across all 26 states and the Federal District with 7-digit IBGE municipal codes
  • District and subdistrict administrative hierarchies nested within Brazilian municipal jurisdictions
  • Intermediate and immediate geographic regions defining socio-economic urban influence zones
  • Metropolitan areas and urban agglomerations with legal demarcation boundaries and component municipalities

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Harmonize Brazilian customer addresses with IBGE municipality codes

    Match city names and federative units in customer profiles against IBGE municipality records, proposing standardized 7-digit codes for electronic invoicing.

    With Address Repair, Tax Exemption

  • Balance regional sales territories across Brazilian states

    Group Brazilian municipalities into immediate and intermediate geographic regions, proposing balanced sales representative territories across major metropolitan clusters.

    With Territory Balance

Requirements

  • Handling of 7-digit IBGE municipal codes and 2-letter state abbreviations (UF)
  • UTF-8 string encoding to properly parse Portuguese diacritics in municipality names
  • Polite request pacing when retrieving complete national municipality hierarchies in bulk
Authentication
None. The IBGE Localidades API is freely accessible without authentication keys, tokens, or registration requirements.

Limits

  • API returns administrative hierarchy metadata and centroid coordinates rather than polygon vector boundaries
  • Boundary modifications enacted by state legislatures update annually in conjunction with IBGE statistical releases
  • Geographic coverage is strictly confined to the national territory of the Federative Republic of Brazil

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request IBGE Localidades API ↗

Questions and answers

What is an IBGE municipality code?
It is a unique 7-digit numerical identifier assigned to each of Brazil's 5,570 municipalities, used across Brazilian government and tax reporting systems.
Does the IBGE Localidades API require an API key?
No. The IBGE Localidades API is an open public REST service that requires no key or account registration.
What license governs IBGE data?
IBGE data is published under the Brazilian open data policy, permitting free commercial and non-commercial reuse with attribution.
Ask about IBGE Localidades API

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by Instituto Brasileiro de Geografia e Estatística (IBGE / servicodados.ibge.gov.br). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy