# Consulta Veicular

> Consulta informações completas de um veículo pela placa, retornando marca, modelo, ano de fabricação e cor. Inclui dados do proprietário e valor de mercado atualizado.

- **Consulta:** `consulta-veicular`
- **Categoria:** Veicular
- **Preço:** R$ 1,99 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/consulta-veicular`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/veicular/consulta-veicular

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint permite obter informações detalhadas sobre um veículo a partir de sua placa. A resposta inclui características técnicas completas (marca, modelo, ano, cilindrada, combustível), dados do proprietário e o valor de mercado do veículo segundo a Tabela FIPE.
>
> Além dos dados básicos do veículo, o serviço retorna indicadores de risco que ajudam na identificação de situações especiais: veículos com histórico de roubo ou furto, ocorrências de recall do fabricante, restrições judiciais, problemas com documentação, e outras flags relevantes para análise de crédito e conformidade.
>
> ### Principais funcionalidades
>
> - **Dados técnicos:** Dimensões, peso, capacidade de carga e passageiros, número de eixos, tipo de carroceria, especificações do motor
> - **Documentação:** Informações sobre registros de emissão (CRLV, CRV), RENAVAM, número do chassi com detecção de remarcações
> - **Valor de mercado:** Cotação da Tabela FIPE do mês corrente, acompanhada do código FIPE e do nome da versão precificada
> - **Informações do proprietário:** Identificação básica do detentor do registro
> - **Indicadores de risco:** Flags para alertar sobre restrições tributárias, processos judiciais, situações de penhor, falhas documentais e outros impedimentos administrativos
>
> Esta consulta é útil para operações de compra e venda veicular, precificação e análise de risco em seguros, gestão e auditoria de frotas, e verificações de conformidade regulatória.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/consulta-veicular?placa=SUA_PLACA"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/consulta-veicular",
    params={"placa": "SUA_PLACA"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/consulta-veicular");

url.search = new URLSearchParams({
  "placa": "SUA_PLACA"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `placa` | texto | sim | Placa do veiculo, com ou sem hifen. Aceita o formato antigo (ABC1234) e o Mercosul (ABC1D23). | formato: AAA0A00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta é estruturada nos seguintes campos principais:
>
> **proprietario** — Nome ou razão social do detentor do registro
>
> **documento** — CPF ou CNPJ associado ao registro do veículo
>
> **anoExercicio** — Ano de exercício da informação
>
> **veiculo** — Objeto contendo detalhes técnicos e administrativos:
> - Identificadores: placa, RENAVAM, chassi, número do motor, número do câmbio
> - Localização: estado, município
> - Classificação: marca, modelo, ano do modelo, ano de fabricação, tipo, espécie, categoria
> - Especificações: combustível, cilindrada, potência, cor, número de eixos, capacidades de carga e tração, peso bruto total
> - Documentação: datas de emissão de registros, informações de carroceria
> - Avaliação: cotação de mercado da Tabela FIPE (bloco `veiculo.fipe`, detalhado abaixo)
> - Restrições: lista de impedimentos registrados
> - Informações complementares: dados sobre faturamento e importação (quando aplicável)
>
> **indicadores** — Sinalizadores booleanos de situações especiais:
> - Remarcação de chassi
> - Comunicado de venda
> - Histórico de leilão
> - Pendência documentária
> - Recall registrado
> - Infrações de trânsito
> - Restrições judiciais
> - Restrições tributárias
> - Ocorrências de roubo ou furto
> - Alarme registrado

### Exemplo de resposta

```json
{
  "veiculo": {
    "uf": "string",
    "cor": "string",
    "fipe": {
      "valor": "string",
      "status": "string",
      "anoModelo": "number",
      "marcaFipe": "string",
      "codigoFipe": "string",
      "modeloFipe": "string",
      "combustivel": "string",
      "mesReferencia": "string",
      "valorNumerico": "number"
    },
    "tipo": "string",
    "marca": "string",
    "placa": "string",
    "chassi": "string",
    "modelo": "string",
    "especie": "string",
    "renavam": "string",
    "faturado": {
      "tipo": "string",
      "documento": "string"
    },
    "potencia": "number",
    "anoModelo": "string",
    "categoria": "string",
    "municipio": "string",
    "cilindrada": "string",
    "importacao": {
      "data": null,
      "numeroDeclaracao": null
    },
    "restricoes": [
      "string"
    ],
    "combustivel": "string",
    "indicadores": {
      "rfb": "boolean",
      "alarme": "boolean",
      "leilao": "boolean",
      "recall": "boolean",
      "siniav": "boolean",
      "renainf": "boolean",
      "renajud": "boolean",
      "rouboFurto": "boolean",
      "comunicadoVenda": "boolean",
      "pendenciaEmissao": "boolean"
    },
    "numeroEixos": "string",
    "numeroMotor": "string",
    "numeroCambio": "string",
    "anoFabricacao": "string",
    "dataEmissaoCrv": "string",
    "pesoBrutoTotal": "string",
    "tipoCarroceria": "string",
    "capacidaDeCarga": null,
    "dataEmissaoCrlv": null,
    "situacaoVeiculo": "string",
    "numeroCarroceria": null,
    "numeroEixoTraseiro": null,
    "procedenciaVeiculo": "string",
    "numeroDoEixoAuxiliar": null,
    "capacidadeMaximaCarga": "string",
    "capacidadeMaximaTracao": "string",
    "capacidadedePassageiros": null,
    "descricaoRemarcacaoChassi": "string",
    "indicadorRemarcacaoChassi": "boolean"
  },
  "documento": "string",
  "anoExercicio": "string",
  "proprietario": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "veiculo": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "uf": {
          "type": [
            "string",
            "null"
          ],
          "description": "Unidade Federativa do registro."
        },
        "cor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Cor do veículo."
        },
        "fipe": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "valor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor de mercado do veiculo segundo a Tabela Fipe, formatado em reais (ex.: 'R$ 23.241,00'). Null quando nao ha valor Fipe disponivel para o modelo — ver `status`."
            },
            "status": {
              "type": [
                "string",
                "null"
              ],
              "description": "Frase explicando o desfecho da avaliacao Fipe — em especial POR QUE o valor veio nulo: tipo de veiculo que a Fipe nao tabela (reboque/semirreboque), ano indisponivel para o modelo, motorizacao sem correspondencia, ou versao nao identificavel com seguranca. Null quando a avaliacao nao pode ser executada."
            },
            "anoModelo": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Ano-modelo do veiculo que foi precificado (ex.: 2023). E a chave que a Fipe usa para precificar — ela tabela por ano MODELO, nunca por ano de fabricacao. Confira contra `veiculo.anoModelo` (mesmo ano, ali como string): divergencia significa que precificamos o veiculo errado. Um 2022/2023 (fabricado em 2022, modelo 2023) tem `veiculo.anoFabricacao` = '2022' e este campo = 2023, e isso esta correto."
            },
            "marcaFipe": {
              "type": [
                "string",
                "null"
              ],
              "description": "Marca na nomenclatura da Fipe (ex.: 'Citroen'), que pode diferir da grafia do DENATRAN em `veiculo.marca`."
            },
            "codigoFipe": {
              "type": [
                "string",
                "null"
              ],
              "description": "Codigo Fipe do modelo, no formato oficial 'NNNNNN-N' (ex.: '011072-8'). Permite reconferir o preco na fonte oficial e acompanhar o mesmo modelo mes a mes."
            },
            "modeloFipe": {
              "type": [
                "string",
                "null"
              ],
              "description": "Nome completo que a Fipe da a versao precificada (ex.: 'C3 GLX 1.4/ GLX Sonora 1.4 Flex 8V 5p'). Existe para auditoria: e com ele que se confere que o preco e da versao do veiculo consultado, e nao de uma parente."
            },
            "combustivel": {
              "type": [
                "string",
                "null"
              ],
              "description": "Combustivel da versao precificada, como a Fipe o nomeia (ex.: 'Flex', 'Gasolina', 'Diesel'). Difere de `veiculo.combustivel`, que vem do DENATRAN com outra nomenclatura ('ALCOOL/GASOLINA'): sao a MESMA informacao em dois vocabularios, e e o desta chave que corresponde a versao cujo preco esta em `valor`."
            },
            "mesReferencia": {
              "type": [
                "string",
                "null"
              ],
              "description": "Mes/ano da TABELA DE REFERENCIA Fipe consultada, no formato 'MM/AAAA' (ex.: '07/2026'). Descreve a TABELA DE PRECOS, nao o veiculo — o ano do veiculo esta em `anoModelo`. E sempre a tabela do mes corrente."
            },
            "valorNumerico": {
              "type": [
                "number",
                "null"
              ],
              "description": "O mesmo valor em numero, para calculo direto sem parse (ex.: 23241.0). Null sempre que `valor` for null."
            }
          },
          "description": "Valor de referencia da Tabela Fipe para o veiculo identificado, da tabela do MES CORRENTE. Quando nao ha valor seguro para o modelo, os campos vem nulos e `status` explica o motivo — a consulta veicular continua respondendo normalmente."
        },
        "tipo": {
          "type": [
            "string",
            "null"
          ],
          "description": "Tipo de veículo."
        },
        "marca": {
          "type": [
            "string",
            "null"
          ],
          "description": "Marca do veículo."
        },
        "placa": {
          "type": [
            "string",
            "null"
          ],
          "description": "Placa do veículo."
        },
        "chassi": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número do chassi."
        },
        "modelo": {
          "type": [
            "string",
            "null"
          ],
          "description": "Modelo do veículo."
        },
        "especie": {
          "type": [
            "string",
            "null"
          ],
          "description": "Espécie do veículo."
        },
        "renavam": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número RENAVAM."
        },
        "faturado": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "tipo": {
              "type": [
                "string",
                "null"
              ],
              "description": "Tipo de faturamento."
            },
            "documento": {
              "type": [
                "string",
                "null"
              ],
              "description": "Documento relacionado ao faturamento."
            }
          },
          "description": "Informações de faturamento do veículo."
        },
        "potencia": {
          "type": [
            "number",
            "null"
          ],
          "description": "Potência do motor em cavalos-vapor."
        },
        "anoModelo": {
          "type": [
            "string",
            "null"
          ],
          "description": "Ano do modelo do veículo."
        },
        "categoria": {
          "type": [
            "string",
            "null"
          ],
          "description": "Categoria do veículo."
        },
        "municipio": {
          "type": [
            "string",
            "null"
          ],
          "description": "Município de registro."
        },
        "cilindrada": {
          "type": [
            "string",
            "null"
          ],
          "description": "Cilindrada do motor em cc."
        },
        "importacao": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "data": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data da importação."
            },
            "numeroDeclaracao": {
              "type": [
                "string",
                "null"
              ],
              "description": "Número da declaração de importação."
            }
          },
          "description": "Informações de importação do veículo."
        },
        "restricoes": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": "Lista de restrições do veículo."
        },
        "combustivel": {
          "type": [
            "string",
            "null"
          ],
          "description": "Tipo de combustível utilizado."
        },
        "indicadores": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "rfb": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Restrição junto à Receita Federal do Brasil."
            },
            "alarme": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Presença de alarme registrado."
            },
            "leilao": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Veículo participou ou participa de leilão."
            },
            "recall": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Recall registrado pelo fabricante."
            },
            "siniav": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Registro no sistema de sinistros."
            },
            "renainf": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Infrações registradas no RENAINF."
            },
            "renajud": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Restrição judicial no RENAJUD."
            },
            "rouboFurto": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Ocorrência de roubo ou furto registrada."
            },
            "comunicadoVenda": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Comunicado de venda registrado."
            },
            "pendenciaEmissao": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Pendência de emissão de documento."
            }
          },
          "description": "Indicadores e flags de situações especiais do veículo."
        },
        "numeroEixos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número de eixos do veículo."
        },
        "numeroMotor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número de série do motor."
        },
        "numeroCambio": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número de série do câmbio."
        },
        "anoFabricacao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Ano de fabricação do veículo."
        },
        "dataEmissaoCrv": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data de emissão do Certificado de Registro de Veículo."
        },
        "pesoBrutoTotal": {
          "type": [
            "string",
            "null"
          ],
          "description": "Peso bruto total em toneladas."
        },
        "tipoCarroceria": {
          "type": [
            "string",
            "null"
          ],
          "description": "Tipo de carroceria."
        },
        "capacidaDeCarga": {
          "type": [
            "string",
            "null"
          ],
          "description": "Capacidade de carga especificada."
        },
        "dataEmissaoCrlv": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data de emissão do Certificado de Registro e Licenciamento de Veículo."
        },
        "situacaoVeiculo": {
          "type": [
            "string",
            "null"
          ],
          "description": "Situação atual do veículo."
        },
        "numeroCarroceria": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número de série da carroceria."
        },
        "numeroEixoTraseiro": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número do eixo traseiro."
        },
        "procedenciaVeiculo": {
          "type": [
            "string",
            "null"
          ],
          "description": "Procedência do veículo."
        },
        "numeroDoEixoAuxiliar": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número do eixo auxiliar se aplicável."
        },
        "capacidadeMaximaCarga": {
          "type": [
            "string",
            "null"
          ],
          "description": "Capacidade máxima de carga em toneladas."
        },
        "capacidadeMaximaTracao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Capacidade máxima de tração em toneladas."
        },
        "capacidadedePassageiros": {
          "type": [
            "string",
            "null"
          ],
          "description": "Capacidade máxima de passageiros."
        },
        "descricaoRemarcacaoChassi": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição detalhada da remarcação de chassi."
        },
        "indicadorRemarcacaoChassi": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indicador de remarcação de chassi."
        }
      },
      "description": "Dados do veículo consultado."
    },
    "documento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Documento do proprietário (CPF ou CNPJ)."
    },
    "anoExercicio": {
      "type": [
        "string",
        "null"
      ],
      "description": "Ano de exercício da consulta."
    },
    "proprietario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do proprietário do veículo."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Avaliação de mercado (bloco `veiculo.fipe`)

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> | Campo | Descrição |
> |---|---|
> | `valor` | Valor de mercado segundo a Tabela FIPE, em reais (ex.: `R$ 23.241,00`) |
> | `valorNumerico` | O mesmo valor em número (`23241.0`), para cálculo direto sem parse |
> | `mesReferencia` | Mês/ano da **tabela** FIPE consultada, em `MM/AAAA` (ex.: `07/2026`) — **não** é o mês/ano do veículo |
> | `anoModelo` | Ano-modelo do **veículo** que foi precificado (ex.: `2023`) — o mesmo ano de `veiculo.anoModelo`, aqui como número |
> | `combustivel` | Combustível da versão precificada, na nomenclatura da FIPE (`Flex`) — a mesma informação que `veiculo.combustivel` traz na do DENATRAN (`ALCOOL/GASOLINA`) |
> | `codigoFipe` | Código FIPE do modelo (ex.: `011072-8`) — permite reconferir o preço na fonte oficial e acompanhar o mesmo modelo mês a mês |
> | `modeloFipe` | Nome completo da versão precificada, na nomenclatura da FIPE |
> | `marcaFipe` | Marca na nomenclatura da FIPE (pode diferir da grafia do DENATRAN em `veiculo.marca`) |
> | `status` | Frase explicando o desfecho da avaliação — em especial, **por que** o valor veio nulo |
>
> A tabela consultada é **sempre a do mês corrente**, e `mesReferencia` diz explicitamente de qual mês é o preço.
>
> ### Atenção aos anos: a resposta tem três, e são coisas diferentes
>
> | Campo | O que é |
> |---|---|
> | `veiculo.anoFabricacao` | Quando o veículo saiu da fábrica |
> | `veiculo.anoModelo` / `veiculo.fipe.anoModelo` | O ano-modelo — **é por ele que a FIPE precifica** |
> | `veiculo.fipe.mesReferencia` | O mês/ano da **tabela FIPE** consultada (`07/2026`), não do carro |
>
> É normal que os dois primeiros diferem: um veículo `2022/2023` foi fabricado em 2022 e vendido como modelo 2023, e o preço correto é o do **modelo 2023**. A FIPE tabela por ano-modelo e nunca por ano de fabricação. Já `fipe.mesReferencia` vale o mês corrente (`07/2026`) em toda consulta, porque descreve a tabela de preços — se você procura o ano do veículo, use `fipe.anoModelo`.
>
> ### Quando o valor FIPE vem nulo
>
> O valor de mercado é informado **quando há Tabela FIPE disponível para o veículo**. Um preço errado é pior que um preço ausente — é número que orienta compra, venda e indenização — então, na dúvida entre versões de preços diferentes, o bloco vem com `valor: null` e o motivo em `status`, em vez de um número chutado. Os casos:
>
> - **Tipo sem Tabela FIPE.** A FIPE cobre carro, moto e caminhão. **Reboque e semirreboque não têm Tabela FIPE** e nunca terão — cerca de 3% das consultas caem aqui. Não é falha da consulta: é como a fonte funciona.
> - **Ano-modelo indisponível.** O modelo existe na FIPE, mas não naquele ano-modelo.
> - **Versão não identificada com segurança.** O registro do DENATRAN abrevia o nome do modelo (`C3 GLX 14 FLEX`) e a FIPE usa o nome comercial completo (`C3 GLX 1.4/ GLX Sonora 1.4 Flex 8V 5p`); há versões homônimas com preços diferentes. Quando nenhuma candidata se destaca o suficiente, o valor não é emitido.
> - **Motorização sem correspondência.** Nenhuma versão da FIPE bate com a cilindrada registrada.
>
> Em todos esses casos a consulta responde normalmente, com **HTTP 200** e a ficha cadastral completa: o bloco `veiculo.fipe` é um complemento, não uma condição de sucesso. O mesmo vale se a FIPE estiver momentaneamente indisponível.
>
> Se você já sabe marca, modelo e ano-modelo e quer apenas o preço, sem a ficha cadastral, use a consulta **Tabela FIPE — Valor de Veículo**.

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - A placa pode ser informada com ou sem formatação padrão (com ou sem hífen)
> - Todos os indicadores retornam como valores booleanos (verdadeiro ou falso)
> - Nem todo veículo possui registros em todas as categorias (faturamento, importação, restrições) — estes campos podem estar vazios quando não aplicáveis
> - A avaliação de mercado usa a Tabela FIPE do mês corrente e é informada quando disponível para o veículo (ver acima)
> - A FIPE publica **preço médio de mercado**, não avaliação individual: estado de conservação, quilometragem, opcionais e histórico do veículo não entram no número
> - Em caso de inconsistências nos dados retornados ou dúvidas sobre registros específicos, consulte os órgãos de trânsito responsáveis pela emissão dos documentos

---

Página em HTML: https://fontedata.com/docs/veicular/consulta-veicular
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp