IBGE Estados

Carregue as 27 unidades da federação na API de localidades do IBGE e compare id, sigla, nome e região em uma mesma lista.

Documentação

Resposta pública atual

Carregue a lista e leia id, sigla, nome e regiao juntos. A documentação também disponibiliza /api/v1/localidades/estados/{id} para uma unidade cujo id você já conhece.

O que a consulta retorna

Carregue as 27 unidades da federação na API de localidades do IBGE e compare id, sigla, nome e região em uma mesma lista.

A lista serve para padronizar referências territoriais, mas não confirma endereço, município, CEP, zona de entrega, DDD, residência ou localização atual de uma pessoa. Para um caso concreto, consulte a fonte compatível com a finalidade e os dados completos do local.

Campos que merecem atenção

id: código da unidade federativa
sigla: duas letras da UF
nome: unidade federativa
regiao: id, sigla e nome

O que cada registro traz

A lista de estados retorna 27 unidades da federação. Em cada registro, id é o código numérico usado pela API, sigla identifica a UF com duas letras e nome traz sua denominação. O objeto regiao tem outro id, sigla e nome, referentes à região brasileira da unidade.

Não confunda o id do estado com o id dentro de regiao.
Use a sigla quando o campo pede UF, como GO ou SP.
Use nome para exibição e id quando a integração exige o código da API.

Como consultar uma unidade

O botão desta página carrega a lista inteira, o que permite conferir uma sigla ao lado do nome e da região. Quando o id já for conhecido, a documentação do IBGE mostra a rota /api/v1/localidades/estados/{id}; por exemplo, a consulta 52 retorna Goiás.

Compare o registro completo antes de copiar um identificador.
Procure a unidade por nome e confirme a sigla no mesmo item.
Use a rota por id somente depois de obter o código da fonte.

Limites da classificação

A região na resposta é uma classificação territorial do IBGE. Ela não informa onde alguém mora, não calcula distância e não substitui endereço completo, CEP ou consulta de município. Para logística, atendimento ou cadastro, combine a referência estadual com a fonte específica do local.

Não deduza município ou bairro a partir da sigla da UF.
Não use a lista para validar uma zona de entrega.
Confirme endereços em fonte apropriada ao caso concreto.