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.
curl -H "X-API-Key: SUA_CHAVE" \
"https://app.fontedata.com/api/v1/consulta/frotas-nacional?cpf=SEU_CPF"| Nome | Tipo | Descrição | Exemplo |
|---|---|---|---|
| cpf condicional | CPF | CPF do proprietário, com ou sem máscara. Informe cpf OU cnpj. | 000.000.000-00 |
| cnpj condicional | CNPJ | CNPJ do proprietário, com ou sem máscara. Informe cpf OU cnpj. | 00.000.000/0000-00 |
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ículomarcaModelo — Marca e modelo (ex.: VW/GOL 1.0)cor — Cor predominanteanoFabricacao — Ano de fabricaçãoanoModelo — Ano do modelouf — UF de registro do veículotipoVeiculo — Tipo do veículo (frequentemente vazio na fonte)chassi — Número do chassirenavam — Número do RENAVAMmotor — Número do motor (frequentemente vazio na fonte)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.
{
"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
}{
"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ó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. |
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.