Validador de Código IBGE de Cidade

Código IBGE de município: o identificador de 7 dígitos de toda cidade brasileira

O código IBGE de município e o identificador numérico de 7 dígitos que o Instituto Brasileiro de Geografia e Estatistica atribui a cada um dos 5.570 municipios brasileiros (contagem do Censo 2022), mais o Distrito Federal. E a chave canônica usada por praticamente todo dataset público, layout fiscal e programa federal que precisa diferenciar uma cidade brasileira de outra com mesmo nome — e ha dezenas dessas colisoes, como Santa Cruz (RN, MG, PB), Nova Esperanca ou São José.

Diferente do CEP, que agrupa quadras de ruas e muda com frequência, o código IBGE e geopolitico: so muda quando uma cidade e criada, fundida ou desmembrada. Uma vez emitido, o código nunca e reatribuido a outro município, mesmo que o original deixe de existir. Essa estabilidade o torna a chave preferida para juntar dados do censo, eleicoes (TSE), saúde (DATASUS), educação (INEP) e tributacao (RFB).

Anatomia dos 7 dígitos

O código segue layout fixo que permite validação parcial por inspecao:

• Dígitos 1 e 2: código da unidade federativa (UF), de 11 (Rondonia) a 53 (Distrito Federal), igual a tabela UF do SIAFI/RFB.
• Dígitos 3 a 6: microcodigo sequencial atribuído pelo IBGE quando o município e reconhecido.
• Dígito 7: dígito verificador histórico calculado originalmente pelo IBGE; hoje a maioria dos validadores exige apenas comprimento 7 e prefixo UF correto.

Exemplos reais da tabela canônica: 3550308 São Paulo capital (SP), 3304557 Rio de Janeiro capital (RJ), 5300108 Brasilia (DF), 3106200 Belo Horizonte (MG), 4205407 Florianopolis (SC), 4314902 Porto Alegre (RS), 2304400 Fortaleza (CE), 2611606 Recife (PE), 2927408 Salvador (BA), 1302603 Manaus (AM), 1501402 Belem (PA), 5208707 Goiania (GO), 5103403 Cuiaba (MT), 5002704 Campo Grande (MS).

Tabela de prefixos UF

O código UF de 2 dígitos e o mesmo em todos os layouts federais (NF-e, eSocial, IRRF). Use como sanity check rápido:

• 11 RO, 12 AC, 13 AM, 14 RR, 15 PA, 16 AP, 17 TO
• 21 MA, 22 PI, 23 CE, 24 RN, 25 PB, 26 PE, 27 AL, 28 SE, 29 BA
• 31 MG, 32 ES, 33 RJ, 35 SP
• 41 PR, 42 SC, 43 RS
• 50 MS, 51 MT, 52 GO, 53 DF

Note as lacunas intencionais (34, 44, 54 não existem). A numeração foi fixada nos anos 1970 e preserva a hierarquia original da federação.

Usos obrigatórios em layouts do governo eletronico

O código IBGE e requerido em dezenas de envios obrigatórios:

• NF-e — campos cMun (município da operação), cMunFG (fato gerador) e cMunDescarga.
• NFS-e — o ISS sobre serviço e recolhido para o município identificado pelo código IBGE, não pelo CEP.
• eSocial — layouts S-1010 (Estabelecimento) e S-2200 (Admissao) exigem codMunic do local de trabalho.
• RAIS, CAGED, DIRF, IRRF — segmentacao geografica sempre por código IBGE.
• SUS DATASUS — bases de hospitais e procedimentos chaveadas por código.
• SIOPS, FINBRA — relatórios de financas publicas.
• Registro civil, MapBiomas, alertas de desmatamento INPE — crosswalks geograficos.

APIs publicas gratuitas e o stack BR

O IBGE publica uma API REST publica e gratuita em servicodados.ibge.gov.br/api/v1/localidades/municipios. Suporta filtros por UF (/estados/SP/municipios), região e mesorregiao. O endpoint não exige chave de API e limita a algumas milhares de requisições por hora por IP. A resposta e JSON com campos id (código de 7 dígitos), nome, microrregiao, mesorregiao, UF.

A BrasilAPI mantida pela comunidade (brasilapi.com.br/api/ibge/municipios/v1/{UF}) embrulha os mesmos dados com cache extra e CORS aberto por padrão — útil para checkouts de e-commerce que precisam popular um dropdown de cidade depois que o cliente escolhe a UF. Juntas, IBGE e BrasilAPI cobrem ~99% das necessidades de geo-lookup de uma fintech, marketplace ou logística brasileira.

Curiosidades e casos de borda

Fatos úteis ao construir features geograficas brasileiras:

• Maior município em área: Altamira (PA), código 1502400, cobrindo 159.696 km² — maior que todo o estado do Acre e muitos paises europeus.
• Menor em área: Santa Cruz de Minas (MG), código 3158300, apenas 3,565 km².
• Mais populoso: São Paulo capital com ~11,5 milhões de habitantes.
• Menos populoso: Serra da Saudade (MG), com ~770 habitantes (Censo 2022).
• O Distrito Federal e um caso especial: código único 5300108 para todo o DF, ainda que administrativamente dividido em Regiões Administrativas (RAs) que não são municipios.
• CNEFE (Cadastro Nacional de Endereços para Fins Estatisticos) faz o cruzamento entre cada código IBGE e todo endereço da pesquisa censitaria.
• Códigos de municipios extintos permanecem na tabela histórica do IBGE para sempre — nunca são reciclados.

FAQ

A API do IBGE e realmente gratuita?

Sim. servicodados.ibge.gov.br e um serviço público mantido com recursos do contribuinte e não exige cadastro nem chave de API. Tem rate limit para evitar abuso, mas e generosa para uso em produção.

O código pode mudar para uma cidade existente?

Não. Uma vez emitido, o código de 7 dígitos e vitalício. Se uma cidade e fundida ou desmembrada, um código novo e criado para a nova entidade, mas o original e preservado em tabelas históricas. Isso e crítico para analises longitudinais do censo.

Quantos municipios existem hoje?

5.570, conforme a tabela de referência do Censo IBGE 2022. O número esta estável desde 2013 porque a maioria das constituicoes estaduais apertou as regras de criacao de novos municipios após a CF/1988 ter permitido divisão quase livre.

O código IBGE e o mesmo que o código SIAFI ou TSE?

Não, são distintos. O SIAFI usa código de 4 dígitos para centros de custo fiscais; o TSE usa código próprio de 5 dígitos para zonas eleitorais. O código IBGE de 7 dígitos e o mais amplamente adotado, mas layouts federais podem exigir tabelas de conversão ao integrar dados do TSE ou SIAFI.

Duas cidades podem ter o mesmo nome?

Sim, com muita frequência. Santa Cruz, Nova Esperanca, São José e Cruzeiro aparecem dezenas de vezes na federação. O código IBGE e a única forma de diferencia-las com confianca em software.