IBGE Estados

Chargez les 27 unités fédératives dans l API de localités de l IBGE et comparez id, sigle, nom et région dans une même liste.

Documentation officielle

Réponse publique actuelle

Chargez la liste et lisez id, sigla, nome et regiao ensemble. La documentation propose aussi /api/v1/localidades/estados/{id} pour une unité dont vous connaissez déjà l id.

Ce que contient la réponse

Chargez les 27 unités fédératives dans l API de localités de l IBGE et comparez id, sigle, nom et région dans une même liste.

La liste aide à normaliser des références territoriales, mais ne confirme ni adresse, ni commune, ni code postal, ni zone de livraison, ni indicatif téléphonique, ni résidence, ni position actuelle d une personne. Pour un cas concret, utilisez une source adaptée au but et les données complètes du lieu.

Champs à vérifier

id : code de l unité fédérative
sigla : abréviation de deux lettres
nome : nom de l unité fédérative
regiao : id, sigla et nom

Ce que contient chaque fiche

La liste des États renvoie 27 unités fédératives. Dans chaque fiche, id est le code numérique utilisé par l API, sigla identifie l UF avec deux lettres et nome donne sa dénomination. L objet regiao possède un autre id, sigla et nome pour la région brésilienne de cette unité.

Ne confondez pas l id de l État avec celui de regiao.
Utilisez sigla lorsqu un champ demande une UF, comme GO ou SP.
Utilisez nome pour l affichage et id lorsqu une intégration demande le code de l API.

Consulter une unité

Le bouton de cette page charge la liste complète, ce qui permet de vérifier un sigle avec son nom et sa région. Lorsque l id est connu, la documentation IBGE montre /api/v1/localidades/estados/{id} ; par exemple, la requête 52 renvoie Goiás.

Comparez la fiche complète avant de copier un identifiant.
Trouvez une unité par son nom puis confirmez son sigle dans le même élément.
Utilisez la route par id seulement après avoir obtenu le code auprès de la source.

Limites de la classification

La région de la réponse est une classification territoriale de l IBGE. Elle ne dit pas où habite une personne, ne calcule pas de distance et ne remplace ni adresse complète, ni code postal, ni recherche de commune. Pour la logistique, le service ou l inscription, associez la référence de l État à une source propre au lieu.

Ne déduisez pas une commune ou un quartier à partir d un sigle UF.
N utilisez pas la liste pour valider une zone de livraison.
Confirmez les adresses dans une source adaptée au cas concret.