v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB
Municípios

Listar ou filtrar municípios

Retorna municípios conforme filtros.

get/municipios

Query parameters

sigla_ufstring

Sigla da UF (ex. PR)

nome_municipiostring

Nome exato do município (retorna em geral um registro)

nomestring

Parte do nome do município (busca parcial)

status_nfse'ativo' | 'fora_do_ar' | 'pausado' | 'em_implementacao' | 'em_reimplementacao' | 'inativo' | 'nao_implementado'

Status operacional da NFSe no município

Status da emissão de NFSe no município

offsetinteger

Deslocamento para paginação. A API retorna até 100 registros por requisição (0 = primeiros 100, 100 = registros 101–200, etc.).

limitinteger

Quantidade máxima de municípios por página (padrão 50). Use com offset para paginar.

Response

Requisição processada com sucesso

codigo_municipiostring

Código do município (IBGE)

nome_municipiostring

Nome oficial do município (IBGE)

sigla_ufstring

Sigla da UF

nome_ufstring

Nome completo do estado

nfse_habilitadaboolean

Indica se a NFSe está implementada para o município

requer_certificado_nfseboolean nullable

Se exige certificado digital para emissão de NFSe

possui_ambiente_homologacao_nfseboolean nullable

Se existe ambiente de homologação de NFSe

possui_cancelamento_nfseboolean nullable

Se o cancelamento de NFSe é possível via API

provedor_nfsestring nullable

Nome do provedor de NFSe

endereco_obrigatorio_nfseboolean nullable

Obrigatoriedade de endereço na emissão (true/false/null = indefinido)

cpf_cnpj_obrigatorio_nfseboolean nullable

Obrigatoriedade de CPF/CNPJ (true/false/null = indefinido)

codigo_cnae_obrigatorio_nfseboolean nullable

Obrigatoriedade de código CNAE (true/false/null = indefinido)

item_lista_servico_obrigatorio_nfseboolean nullable

Obrigatoriedade de item da lista de serviço

codigo_tributario_municipio_obrigatorio_nfseboolean nullable

Obrigatoriedade de código tributário municipal

status_nfse'ativo' | 'fora_do_ar' | 'pausado' | 'em_implementacao' | 'em_reimplementacao' | 'inativo' | 'nao_implementado'

Status operacional da NFSe no município

data_previsao_reimplementacao_nfsestring date nullable

Data prevista de reimplementação (YYYY-MM-DD); null se não houver

ultima_emissao_nfsestring date-time nullable

Data/hora da última emissão de NFSe via API (ISO 8601)