IBGE Estados

Carga las 27 unidades federativas en la API de Localidades del IBGE y compara id, sigla, nombre y región en una misma lista.

Documentación oficial

Respuesta pública actual

Carga la lista y lee id, sigla, nome y regiao en conjunto. La documentación también ofrece /api/v1/localidades/estados/{id} para una unidad cuyo id ya conoces.

Qué contiene la respuesta

Carga las 27 unidades federativas en la API de Localidades del IBGE y compara id, sigla, nombre y región en una misma lista.

La lista sirve para normalizar referencias territoriales, pero no confirma dirección, municipio, código postal, zona de entrega, código telefónico, residencia ni ubicación actual de una persona. Para un caso concreto, consulta una fuente compatible con la finalidad y los datos completos del lugar.

Campos que conviene revisar

id: código de la unidad federativa
sigla: abreviatura de dos letras
nome: nombre de la unidad federativa
regiao: id, sigla y nombre

Qué contiene cada registro

La lista de estados devuelve 27 unidades federativas. En cada registro, id es el código numérico usado por la API, sigla identifica la UF con dos letras y nome aporta su denominación. El objeto regiao tiene otro id, sigla y nome correspondientes a la región brasileña de la unidad.

No confundas el id del estado con el id dentro de regiao.
Usa sigla cuando un campo pida UF, como GO o SP.
Usa nome para mostrar y id cuando una integración exija el código de la API.

Cómo consultar una unidad

El botón de esta página carga la lista completa, por lo que puedes comprobar una sigla junto al nombre y la región. Cuando ya conoces el id, la documentación del IBGE muestra /api/v1/localidades/estados/{id}; por ejemplo, la consulta 52 devuelve Goiás.

Compara el registro completo antes de copiar un identificador.
Busca una unidad por nombre y confirma la sigla en el mismo elemento.
Usa la ruta por id solo después de obtener el código de la fuente.

Límites de la clasificación

La región de la respuesta es una clasificación territorial del IBGE. No indica dónde vive alguien, no calcula distancias ni sustituye una dirección completa, código postal o consulta de municipio. Para logística, atención o registro, combina la referencia estatal con una fuente específica del lugar.

No deduzcas municipio o barrio a partir de una sigla de UF.
No uses la lista para validar una zona de entrega.
Confirma direcciones en una fuente adecuada al caso concreto.