API de consulta veicular por placa
O endpoint de placa aceita o formato antigo (ABC1234) e o Mercosul (ABC1D23) e retorna os dados do veículo — marca, modelo, ano de fabricação/modelo, cor, combustível, UF e situação — em estrutura normalizada. É usado em análise de risco, seguros, regularização e cobrança.
Para que serve
- Seguros e análise de risco: conferir dados do veículo pela placa.
- Regularização e vistoria: validar marca/modelo/ano antes de negociar.
- Cobrança e recuperação: apoio à identificação de bens em processos autorizados.
Requisição
Autentique com o header Authorization: Bearer — gere seu token no dashboard após ativar um plano.
curl -X POST "https://apiconsultas.xyz/api/v1/consultas/placa" \
-H "Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"placa":"ABC1D23"}'const res = await fetch("https://apiconsultas.xyz/api/v1/consultas/placa", {
method: "POST",
headers: {
Authorization: "Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({"placa":"ABC1D23"}),
});
const data = await res.json();<?php
$ch = curl_init("https://apiconsultas.xyz/api/v1/consultas/placa");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => '{"placa":"ABC1D23"}',
]);
$data = json_decode(curl_exec($ch), true);Resposta (200)
Exemplo com valores ilustrativos. O nível de detalhe (dados completos ou mascarados) depende do seu plano.
{
"success": true,
"tipo_consulta": "placa",
"query": {
"termo_mascarado": "ABC1D23",
"finalidade": "analise_risco"
},
"resultado_count": 1,
"data_quality": {
"sources_used": 1,
"confidence_score": 88,
"has_vehicles": true
},
"data": [
{
"veiculos": [
{
"placa": "ABC1D23",
"marca": "MARCA EXEMPLO",
"modelo": "MODELO EXEMPLO 1.0",
"ano_fabricacao": "2020",
"ano_modelo": "2021",
"cor": "PRATA",
"uf": "SP",
"situacao_veiculo": "SEM RESTRIÇÃO"
}
]
}
],
"audit": {
"logged": true,
"timestamp": "2026-07-01T12:00:00.000Z"
},
"message": "Consulta realizada com sucesso."
}Campos retornados
| Campo | Descrição |
|---|---|
| veiculos[].placa | Placa (antiga e/ou Mercosul). |
| veiculos[].marca / modelo | Marca e modelo do veículo. |
| veiculos[].ano_fabricacao / ano_modelo | Anos de fabricação e modelo. |
| veiculos[].cor / combustivel_codigo | Cor e combustível. |
| veiculos[].uf / situacao_veiculo | UF de registro e situação do veículo. |
| veiculos[].chassi / renavam | Chassi e RENAVAM (mascarados conforme plano). |
Perguntas frequentes
Aceita placa Mercosul?
Sim. Tanto o padrão antigo (ABC1234) quanto o Mercosul (ABC1D23) são aceitos. Placas em formato inválido retornam erro 400.
Retorna dados do proprietário?
A resposta é centrada nos dados do veículo. Campos vinculados ao proprietário, quando presentes, seguem o mascaramento do seu plano e a finalidade legítima declarada.
Serve para compra de veículo usado?
Sim, como apoio: você confere marca, modelo, ano e situação antes de fechar negócio. Para o laudo oficial completo, consulte também os órgãos de trânsito.
Endpoints relacionados
Integre consulta veicular por placa hoje
Ative um plano a partir de R$ 10, gere seu token Bearer e comece a consultar em minutos. Consultas ilimitadas enquanto o plano estiver ativo.