# Obtém Município por ID

> Parâmetros, exemplos e respostas de GET /v1/municipios/{id} na NextAPI.

Fonte: https://www.nextapi.com.br/docs/api/get-v1-municipios-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: cabeçalho `Authorization: Bearer SEU_TOKEN`.

## Exemplo de requisição

```bash
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 |

Autenticação e limites também podem gerar erros antes da execução da operação. Veja o [guia de tratamento de erros](https://www.nextapi.com.br/docs/erros.md).

## Resposta de sucesso

Exemplo estrutural gerado do schema: os valores são ilustrativos. Campos anuláveis podem retornar `null`.

```json
{
  "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 | — |