Obtém Município por ID

GET/v1/municipios/{id}

Obtém os dados completos de um município específico pelo seu ID. - Retorna todos os dados do município incluindo população, empresas e divisões territoriais. - Cada consulta consome 1 crédito. - Disponível somente nos planos pagos.

URL base: https://api.nextapi.com.br. Autenticação: Authorization: Bearer SEU_TOKEN.

Exemplo de requisição

Substitua os valores de exemplo pelos dados da sua consulta. O código não executa uma chamada automaticamente.

cURL

curl --request GET 'https://api.nextapi.com.br/v1/municipios/ID_MUNICIPIO' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Accept: application/json'

Parâmetros

Nome	Local	Obrigatório	Tipo / regras	Descrição
`id`	path	Sim	`integer (int32)`	ID do município

Respostas HTTP

Status	Descrição	Formato JSON
`200`	Operação realizada com sucesso	MunicipioDetalhadoResponse
`400`	Erro nos parametros informados na requisição	IErrorCodeModel
`404`	Registro não localizado	IErrorCodeModel
`405`	Falta de créditos para realizar a consulta	IErrorCodeModel
`500`	Erro ao processar a requisição	IErrorCodeModel

Envie Accept: application/json para solicitar JSON. Autenticação e limites também podem gerar erros antes da execução da operação. Consulte o guia de tratamento de erros.

Resposta de sucesso

Exemplo estrutural gerado do schema: os valores abaixo são ilustrativos, não representam uma consulta real. Campos anuláveis podem retornar null.

JSON · estrutura ilustrativa

{
  "id": 0,
  "descricao": "string",
  "uf": "string",
  "codigoIbge": "string",
  "populacaoEstimada": 0,
  "regiao": "string",
  "mesorregiao": {
    "codigo": "string",
    "nome": "string"
  },
  "microrregiao": {
    "codigo": "string",
    "nome": "string"
  },
  "regiaoImediata": {
    "codigo": "string",
    "nome": "string"
  },
  "regiaoIntermediaria": {
    "codigo": "string",
    "nome": "string"
  },
  "ibgeAtualizadoEm": "2026-01-01T00:00:00",
  "totalEmpresas": 0
}

Campos da resposta

Modelo: MunicipioDetalhadoResponse

MunicipioDetalhadoResponse

Campo	Tipo	Obrigatório	Descrição / regras
`id`	`integer (int32)`	Sim	—
`descricao`	`string \| null`	Sim	—
`uf`	`string \| null`	Sim	—
`codigoIbge`	`string \| null`	Não marcado no contrato	—
`populacaoEstimada`	`integer (int64) \| null`	Não marcado no contrato	—
`regiao`	`string \| null`	Não marcado no contrato	—
`mesorregiao`	`MunicipioHierarquiaResponse`	Não marcado no contrato	—
`microrregiao`	`MunicipioHierarquiaResponse`	Não marcado no contrato	—
`regiaoImediata`	`MunicipioHierarquiaResponse`	Não marcado no contrato	—
`regiaoIntermediaria`	`MunicipioHierarquiaResponse`	Não marcado no contrato	—
`ibgeAtualizadoEm`	`string (date-time) \| null`	Não marcado no contrato	—
`totalEmpresas`	`integer (int64) \| null`	Não marcado no contrato	—

MunicipioHierarquiaResponse

Campo	Tipo	Obrigatório	Descrição / regras
`codigo`	`string \| null`	Sim	—
`nome`	`string \| null`	Sim	—

Contrato desta operação

OpenAPI · JSON

{
  "tags": [
    "Municípios"
  ],
  "summary": "Obtém Município por ID",
  "description": "Obtém os dados completos de um município específico pelo seu ID.\n\n- Retorna todos os dados do município incluindo população, empresas e divisões territoriais.\n- Cada consulta consome 1 crédito.\n- Disponível somente nos planos pagos.",
  "parameters": [
    {
      "name": "id",
      "in": "path",
      "description": "ID do município",
      "required": true,
      "schema": {
        "type": "integer",
        "format": "int32"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Operação realizada com sucesso",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/MunicipioDetalhadoResponse"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/MunicipioDetalhadoResponse"
          }
        }
      }
    },
    "400": {
      "description": "Erro nos parametros informados na requisição",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        }
      }
    },
    "404": {
      "description": "Registro não localizado",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        }
      }
    },
    "405": {
      "description": "Falta de créditos para realizar a consulta",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        }
      }
    },
    "500": {
      "description": "Erro ao processar a requisição",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        }
      }
    }
  },
  "method": "GET",
  "path": "/v1/municipios/{id}",
  "slug": "get-v1-municipios-id"
}