IBGE Estados

Load the 27 federative units from the IBGE Localities API and compare id, abbreviation, name, and region in one list.

Official docs

Current public response

Load the list and read id, sigla, nome, and regiao together. The documentation also provides /api/v1/localidades/estados/{id} for a unit whose id you already know.

What the response contains

Load the 27 federative units from the IBGE Localities API and compare id, abbreviation, name, and region in one list.

The list is useful for standardizing territorial references, but it does not confirm an address, municipality, ZIP code, delivery area, phone area code, residence, or a person current location. For a concrete case, use a source that fits the purpose and the full place data.

Fields worth checking

id: federative unit code
sigla: two-letter UF abbreviation
nome: federative unit name
regiao: id, abbreviation, and name

What each record contains

The state list returns 27 federative units. In each record, id is the numeric code used by the API, sigla identifies the UF with two letters, and nome gives its denomination. The regiao object has another id, sigla, and nome for the Brazilian region of that unit.

Do not confuse the state id with the id inside regiao.
Use sigla where a UF field is required, such as GO or SP.
Use nome for display and id when an integration requires the API code.

Looking up one unit

This page button loads the full list, so you can check an abbreviation next to its name and region. When the id is known, IBGE documentation shows /api/v1/localidades/estados/{id}; for example, lookup 52 returns Goiás.

Compare the complete record before copying an identifier.
Find a unit by name and confirm its abbreviation in the same item.
Use the id route only after getting the code from the source.

Classification limits

The region in the response is an IBGE territorial classification. It does not say where someone lives, calculate distance, or replace a full address, ZIP code, or municipality lookup. For logistics, service, or registration, combine the state reference with a source specific to the place.

Do not infer a municipality or neighborhood from a UF abbreviation.
Do not use the list to validate a delivery area.
Confirm addresses with a source suited to the concrete case.