Como montar uma lista confiável de estados e capitais brasileiras para projetos reais
Muita gente acha que o trabalho com dados geográficos do Brasil é simples. Basta copiar uma tabela da Wikipedia e pronto. Na prática, já vi projeto inteiro quebrar porque alguém não verificou se o território do Amapá tinha sido atualizado depois da criação do município de Oiapoque em 1981. Os nomes das capitais mudam pouco, mas a correspondência estado-cidade que você colocar no seu banco de dados precisa estar alinhada com a codificação do IBGE, senão vai dar problema na hora de fazer joins com CBOs, CNAEs e listas eleitorais.
A lista completa de estados capitais brasileiras que você realmente vai precisar
Aqui está a relação base, organizada por região, com os nomes oficiais conforme o IBGE. Não tem segredo, mas preste atenção aos acentos e às grafias que variam conforme a versão dos dados que você estiver consumindo. Norte: Rio Branco (AC), Manaus (AM), Alta Floresta d'Oeste (RO), Porto Velho (RO), Macapá (AP), Belém (PA), Palmas (TO), Boa Vista (RR).
Nordeste: São Luís (MA), Teresina (PI), Natal (RN), João Pessoa (PB), Recife (PE), Aracaju (SE), Salvador (BA), Maceió (AL), Fortaleza (CE), João Camarão (TO — note que TO está na região Norte, não aqui). Centro-Oeste: Cuiabá (MT), Goiânia (GO), Campo Grande (MS), Brasília (DF).
Sudeste: São Paulo (SP), Rio de Janeiro (RJ), Belo Horizonte (MG), Vitória (ES). Sul: Curitiba (PR), Florianópolis (SC), Porto Alegre (RS).
👉 Clique no botão abaixo para saber mais sobre o assunto!
Isso dá 26 estados mais o Distrito Federal. Se alguém te apresentar uma lista com 27 itens e estiver errada na contagem, desconfie. Já vi gente confundir o antigo território federal de Roraima com outro estado em tabelas antigas de 1988. O problema que realmente causa dor de cabeça não é decorar a lista. É a inconsistência nos dados quando você tenta cruzar com outras fontes. Eu estava integrando uma planilha de benefícios fiscais com a base oficial do IBGE e percebi que o campo "UF" tinha valores como "TO", "toc", e por aí vai. Cada variação era um registro à parte. A solução foi normalizar tudo para maiúsculas de dois caracteres e fazer um mapeamento manual das abreviações não padronizadas antes de rodar a query. Levei umas quatro horas, mas evitou que o relatório final tivesse dados duplicados e faltando.
Outra coisa que pouca gente leva a sério é a questão do código numérico versus a sigla. O IBGE usa códigos como 11, 13, 15 para os estados do Norte. Se o seu sistema só armazena siglas e precisa gerar relatórios para órgãos públicos, eventualmente você vai precisar desses códigos. Não adianta confiar em conversores automáticos genéricos — cada API tem pequenas variações na ordem e nos valores. O mais seguro é consultar a tabela oficial do IBGE diretamente e importar via script. Para quem quer automatizar isso, o download da tabela de municípios e estados está disponível no site do IBGE em formato CSV. O arquivo de estados tem exatamente 27 linhas, com colunas para código, sigla, nome e região. Você pode baixar direto e alimentar seu banco com um INSERT. O arquivo mais recente corresponde ao território vigente após as divisas de 2023, quando alguns municípios tiveram alterações de vinculação estadual menores.
Há limitações que todo mundo ignora. A primeira é que capitais não são necessariamente os maiores municípios do estado. Florianópolis, por exemplo, tem menos de 500 mil habitantes, enquanto Joinville tem mais de 700 mil, mas a capital continua sendo Florianópolis por decisão histórica e política. Se o seu sistema usar população como proxy para capital, vai.errar-feio. A segunda limitação é que o DF não é um estado, mas funciona como unidade federativa para fins de cálculos. Tabelas que tratam DF como estado e esquecem que ele não tem municípios no mesmo sentido causam bugs chatos em sistemas de endereçamento. Se você está construindo algo novo, recomendo começar pela base do IBGE e manter um arquivo de colação local que você atualiza periodicamente, em vez de fazer requisições em tempo real. A tabela não muda com frequência, mas quando muda — como aconteceu com a criação de novos municípios ou ajustes de divisa — quem não tiver versi versionada acaba com inconsistências silenciosas que só aparecem meses depois.
A lista de estados capitais brasileiras é um dado aparentemente trivial, mas a forma como você a estrutura determina se o resto do projeto funciona sem dor. Trate com a mesma seriedade que trataria uma tabela de CPFs ou de cotações de moeda.
