# Consulta Veicular — Frotas Nacional

> Lista os veículos vinculados a um CPF ou CNPJ em todo o território nacional: placa, marca/modelo, cor, ano, UF, chassi e RENAVAM. Para verificação patrimonial, análise de crédito e gestão de frotas.

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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Lista os **veículos vinculados a um CPF ou CNPJ**, com cobertura **nacional** — não apenas de um estado. Devolve placa, marca/modelo, cor, ano de fabricação e modelo, UF de registro, chassi e RENAVAM de cada veículo.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/frotas-nacional?cpf=SEU_CPF"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/frotas-nacional",
    params={"cpf": "SEU_CPF"},
    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/frotas-nacional");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).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

Informe `cpf` ou `cnpj`.

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | condicional | CPF do proprietário, com ou sem máscara. Informe `cpf` OU `cnpj`. | formato: 000.000.000-00 |
| `cnpj` | CNPJ | condicional | CNPJ do proprietário, com ou sem máscara. Informe `cpf` OU `cnpj`. | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - `documento` — CPF ou CNPJ consultado, com máscara.
> - `proprietario` — Nome ou razão social do proprietário.
> - `quantidadeVeiculos` — Total de veículos que a fonte encontrou para o documento.
> - `veiculos[]` — Lista dos veículos:
>   - `placa` — Placa do veículo
>   - `marcaModelo` — Marca e modelo (ex.: `VW/GOL 1.0`)
>   - `cor` — Cor predominante
>   - `anoFabricacao` — Ano de fabricação
>   - `anoModelo` — Ano do modelo
>   - `uf` — UF de registro do veículo
>   - `tipoVeiculo` — Tipo do veículo (frequentemente vazio na fonte)
>   - `chassi` — Número do chassi
>   - `renavam` — Número do RENAVAM
>   - `motor` — Número do motor (frequentemente vazio na fonte)
>
> ### Duas ressalvas importantes
>
> **1. A lista é limitada a 20 veículos por consulta.** Quando o documento tem uma frota maior, `quantidadeVeiculos` informa o total real, mas `veiculos[]` traz no máximo 20 itens. Sempre compare os dois campos: se `quantidadeVeiculos` for maior que o tamanho da lista, você está vendo uma amostra, não a frota inteira.
>
> **2. A base é atualizada anualmente.** Por esse motivo, veículos adquiridos ou transferidos recentemente podem não estar refletidos no resultado. Considere essa defasagem ao usar a consulta para decisões sobre aquisições recentes.

### Exemplo de resposta

```json
{
  "veiculos": [
    {
      "uf": "SP",
      "cor": "PRATA",
      "motor": null,
      "placa": "ABC-1D23",
      "chassi": "9BWZZZ00000000000",
      "renavam": "000000000",
      "anoModelo": "2019",
      "marcaModelo": "VW/GOL 1.0",
      "tipoVeiculo": null,
      "anoFabricacao": "2018"
    },
    {
      "uf": "MG",
      "cor": "VERMELHA",
      "motor": null,
      "placa": "XYZ-4A56",
      "chassi": "9C2ZZZ00000000000",
      "renavam": "111111111",
      "anoModelo": "2021",
      "marcaModelo": "HONDA/CG 160 TITAN",
      "tipoVeiculo": null,
      "anoFabricacao": "2021"
    }
  ],
  "documento": "123.456.789-09",
  "proprietario": "NOME DO PROPRIETARIO EXEMPLO",
  "quantidadeVeiculos": 2
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "veiculos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "UF de registro do veículo."
          },
          "cor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cor predominante do veículo."
          },
          "motor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do motor. Frequentemente vazio na fonte."
          },
          "placa": {
            "type": [
              "string",
              "null"
            ],
            "description": "Placa do veículo."
          },
          "chassi": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do chassi."
          },
          "renavam": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do RENAVAM."
          },
          "anoModelo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ano do modelo."
          },
          "marcaModelo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Marca e modelo do veículo (ex.: `VW/GOL 1.0`)."
          },
          "tipoVeiculo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo do veículo (automóvel, motocicleta, caminhão…). Frequentemente vazio na fonte."
          },
          "anoFabricacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ano de fabricação."
          }
        }
      },
      "description": "Veículos vinculados ao documento, em todo o território nacional. No máximo 20 itens por consulta."
    },
    "documento": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF ou CNPJ consultado, com máscara."
    },
    "proprietario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome ou razão social do proprietário dos veículos."
    },
    "quantidadeVeiculos": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Total de veículos que a fonte encontrou para o documento. ATENÇÃO: pode ser MAIOR que o número de itens em `veiculos[]` — a fonte devolve no máximo 20 registros por consulta."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Informe `cpf` ou `cnpj`. | Nenhum dos dois parâmetros foi enviado, ou o documento tem formato inválido. |
| `404` | Nenhum registro encontrado para os parâmetros informados. | O documento não consta na base nacional de frotas. Não significa que a pessoa não possui veículo — significa que a fonte não tem registro para esse documento. ATENÇÃO: esta resposta É COBRADA, porque a consulta foi executada na base oficial. |
| `422` | Documento inválido. | O CPF ou CNPJ enviado não é um documento válido. |
| `503` | Serviço de consulta temporariamente indisponível. Tente novamente em instantes. | A fonte está instável ou devolveu erro transitório. |
| `504` | A consulta excedeu o tempo limite. Tente novamente. | A consulta passou do tempo limite. |

## Quando usar

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Use em **verificação patrimonial** (o documento tem veículos em nome próprio?), **análise de crédito e cobrança** (identificação de bens), **gestão e auditoria de frotas** de uma empresa, e **prevenção a fraude** para conferir se o veículo declarado bate com o que consta no nome do titular.
>
> Quando o documento não consta na base, a consulta responde **404** — e isso não afirma que a pessoa não possui veículo, apenas que a fonte não tem registro para o documento. **Essa resposta é cobrada**, como qualquer outra: a consulta foi de fato executada contra a base oficial, e o resultado "não há registro" é a informação entregue.
>
> Se você precisa dos dados de **um veículo específico a partir da placa** (incluindo restrições e características do veículo), use a consulta veicular por placa. Se precisa saber quem é o **credor de um financiamento**, use a consulta de gravame.

---

Página em HTML: https://fontedata.com/docs/veicular/frotas-nacional
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