Veículo por placa completa

A partir da placa: identificação do veículo, proprietário atual, restrições por extenso e alertas de roubo, leilão e Renajud.

Entrada: PlacaAssíncrona (requestId)Exige termo de finalidade

Quando usar

Compra e venda

Confira proprietário, restrições e alertas antes de fechar negócio ou transferir.

Financiamento

Verifique alienação fiduciária, Renajud e leilão antes de aceitar o veículo como garantia.

Seguro

Cheque roubo, furto e leilão antes de emitir a apólice.

Exige termo de finalidade

Antes da primeira chamada, aceite o termo desta consulta no painel, em Minha conta > Aceites e finalidade. Sem o aceite, a criação responde 403 com o código PURPOSE_NOT_ACCEPTED.

O proprietário é dado pessoal

Use o nome e o documento do proprietário só para a finalidade aceita no termo. É proibido usá-los para localizar ou abordar o proprietário e para montar base própria.

Sem cache

Cada chamada consulta a base nacional e é cobrada, mesmo que a placa já tenha sido consultada antes.

Passo 1

Criar consulta

POST/api/partner/v2/vehicles/full-report

Cria uma consulta assíncrona do veículo pela placa: identificação, proprietário atual, restrições registradas e alertas. Use o requestId retornado no endpoint de resultado.

Importante:

Exige o termo de finalidade de Veículo por placa completa aceito no painel; sem ele a resposta é 403 com code: PURPOSE_NOT_ACCEPTED
O proprietário é dado pessoal de terceiro: use só para a finalidade aceita, nunca para localizar ou abordar o proprietário nem para montar base própria
Sem cache: cada chamada consulta a base nacional e é cobrada
Falhas na consulta são reembolsadas automaticamente

Corpo da requisição

Campo	Tipo	Descrição
`licensePlate` obrigatório	string	Placa no padrão antigo (ABC1234) ou Mercosul (ABC1D23). Hífen e minúsculas são aceitos.

licensePlatestringobrigatório
Placa no padrão antigo (ABC1234) ou Mercosul (ABC1D23). Hífen e minúsculas são aceitos.

Respostas

200Solicitação criada com sucesso
400Placa inválida
401Token ausente ou inválido
402Consulta não habilitada ou saldo insuficiente
403Termo de finalidade não aceito

Requisição

curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/vehicles/full-report" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"licensePlate":"ABC1D23"}'

Resposta · 200

{
  "requestId": "cm8p1q2r30004ab12cdef5678",
  "message": "Solicitação realizada com sucesso"
}

Passo 2

Buscar relatório

GET/api/partner/v2/vehicles/full-report/{requestId}

Consulte este endpoint com o requestId recebido no POST até receber o status done ou error. Sem dados para a placa, found vem false e vehicle e owner vêm null.

Parâmetros do caminho

Campo	Tipo	Descrição
`requestId` obrigatório	string	ID retornado ao criar a consulta

requestIdstringobrigatório
ID retornado ao criar a consulta

Respostas

200Estado atual ou resultado da solicitação
401Token ausente ou inválido
403A solicitação pertence a outro usuário
404Solicitação não encontrada

Requisição

curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/vehicles/full-report/cm8p1q2r30004ab12cdef5678" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Resposta · 200

{
  "data": {
    "licensePlate": "ABC1D23",
    "found": true,
    "checkedAt": "2026-10-27T21:42:21.716Z",
    "vehicle": {
      "chassis": "9BWZZZ377VT004251",
      "renavam": "01234567890",
      "status": "EM CIRCULACAO",
      "brandModel": "VW/GOL 1.0",
      "color": "PRATA",
      "category": "PARTICULAR",
      "species": "PASSAGEIRO",
      "type": "AUTOMOVEL",
      "fuel": "ALCOOL/GASOLINA",
      "manufactureYear": 2020,
      "modelYear": 2021,
      "displacement": 999,
      "power": 84,
      "seats": 5,
      "engineNumber": "ABC123456",
      "registrationCity": "SAO PAULO",
      "state": "SP"
    },
    "owner": {
      "name": "MARIA DA SILVA",
      "document": "12345678901",
      "personType": "individual"
    },
    "restrictions": [
      "ALIENACAO FIDUCIARIA BANCO EXEMPLO"
    ],
    "alerts": {
      "theft": false,
      "auction": false,
      "renajud": false,
      "renainfFine": false,
      "saleNotice": false,
      "recall": null
    }
  },
  "status": "done"
}

O que a resposta traz

Veículo

Chassi, RENAVAM e situação
vehicle.chassis · renavam · status
Marca/modelo, cor, categoria, espécie, tipo e combustível
vehicle.brandModel · color · category · species · type · fuel
Ano de fabricação/modelo, cilindradas, potência, lotação e número do motor
vehicle.manufactureYear · modelYear · displacement · power · seats · engineNumber
Município e UF de emplacamento
vehicle.registrationCity · state

Proprietário

Nome ou razão social
owner.name
CPF ou CNPJ e tipo de pessoa
owner.document · personType
personType vem individual (pessoa física) ou company (pessoa jurídica).

Restrições e alertas

Restrições registradas, por extenso
restrictions[]
Roubo ou furto, leilão e Renajud
alerts.theft · auction · renajud
Multa Renainf, comunicação de venda e recall
alerts.renainfFine · saleNotice · recall
true consta, false nada consta, null não informado pela fonte.

Todos os campos da resposta (35)

Campo	Tipo	Descrição
`status`	string	`done`
`data`	object	Campos sem informação na fonte vêm null.
`data.licensePlate`	string	Ex.: `ABC1D23`
`data.found`	boolean	false quando não há dados para a placa
`data.checkedAt`	string \| null	Momento da consulta na fonte
`data.vehicle`	object \| null
`data.vehicle.chassis`	string \| null	Ex.: `9BWZZZ377VT004251`
`data.vehicle.renavam`	string \| null	Ex.: `01234567890`
`data.vehicle.status`	string \| null	Ex.: `EM CIRCULACAO`
`data.vehicle.brandModel`	string \| null	Ex.: `VW/GOL 1.0`
`data.vehicle.color`	string \| null	Ex.: `PRATA`
`data.vehicle.category`	string \| null	Ex.: `PARTICULAR`
`data.vehicle.species`	string \| null	Ex.: `PASSAGEIRO`
`data.vehicle.type`	string \| null	Ex.: `AUTOMOVEL`
`data.vehicle.fuel`	string \| null	Ex.: `ALCOOL/GASOLINA`
`data.vehicle.manufactureYear`	integer \| null	Ex.: `2020`
`data.vehicle.modelYear`	integer \| null	Ex.: `2021`
`data.vehicle.displacement`	integer \| null	Cilindradas Ex.: `999`
`data.vehicle.power`	integer \| null	Potência em cv Ex.: `84`
`data.vehicle.seats`	integer \| null	Lotação Ex.: `5`
`data.vehicle.engineNumber`	string \| null
`data.vehicle.registrationCity`	string \| null	Ex.: `SAO PAULO`
`data.vehicle.state`	string \| null	Ex.: `SP`
`data.owner`	object \| null	Proprietário atual. Dado pessoal: use só para a finalidade aceita no termo.
`data.owner.name`	string \| null
`data.owner.document`	string \| null	CPF ou CNPJ, só dígitos
`data.owner.personType`	string \| null	`individualcompanynull`
`data.restrictions`	string[]	Restrições registradas, por extenso
`data.alerts`	object	true consta, false nada consta, null não informado pela fonte
`data.alerts.theft`	boolean \| null	Roubo ou furto
`data.alerts.auction`	boolean \| null	Passagem por leilão
`data.alerts.renajud`	boolean \| null	Restrição judicial no Renajud
`data.alerts.renainfFine`	boolean \| null	Multa Renainf pendente
`data.alerts.saleNotice`	boolean \| null	Comunicação de venda
`data.alerts.recall`	boolean \| null	Recall pendente

statusstring
done
dataobject
Campos sem informação na fonte vêm null.
data.licensePlatestring
Ex.: ABC1D23
data.foundboolean
false quando não há dados para a placa
data.checkedAtstring | null
Momento da consulta na fonte
data.vehicleobject | null
data.vehicle.chassisstring | null
Ex.: 9BWZZZ377VT004251
data.vehicle.renavamstring | null
Ex.: 01234567890
data.vehicle.statusstring | null
Ex.: EM CIRCULACAO
data.vehicle.brandModelstring | null
Ex.: VW/GOL 1.0
data.vehicle.colorstring | null
Ex.: PRATA
data.vehicle.categorystring | null
Ex.: PARTICULAR
data.vehicle.speciesstring | null
Ex.: PASSAGEIRO
data.vehicle.typestring | null
Ex.: AUTOMOVEL
data.vehicle.fuelstring | null
Ex.: ALCOOL/GASOLINA
data.vehicle.manufactureYearinteger | null
Ex.: 2020
data.vehicle.modelYearinteger | null
Ex.: 2021
data.vehicle.displacementinteger | null
Cilindradas
Ex.: 999
data.vehicle.powerinteger | null
Potência em cv
Ex.: 84
data.vehicle.seatsinteger | null
Lotação
Ex.: 5
data.vehicle.engineNumberstring | null
data.vehicle.registrationCitystring | null
Ex.: SAO PAULO
data.vehicle.statestring | null
Ex.: SP
data.ownerobject | null
Proprietário atual. Dado pessoal: use só para a finalidade aceita no termo.
data.owner.namestring | null
data.owner.documentstring | null
CPF ou CNPJ, só dígitos
data.owner.personTypestring | null
individualcompanynull
data.restrictionsstring[]
Restrições registradas, por extenso
data.alertsobject
true consta, false nada consta, null não informado pela fonte
data.alerts.theftboolean | null
Roubo ou furto
data.alerts.auctionboolean | null
Passagem por leilão
data.alerts.renajudboolean | null
Restrição judicial no Renajud
data.alerts.renainfFineboolean | null
Multa Renainf pendente
data.alerts.saleNoticeboolean | null
Comunicação de venda
data.alerts.recallboolean | null
Recall pendente

Valores por plano

Sem cobrança em caso de falha

Se a consulta terminar com erro, o valor volta para o saldo automaticamente.

Plano mensal	Valor da consulta
Sob demanda	R$ 9,90
R$ 100/mês até 20 consultas	R$ 4,90
R$ 300/mês até 71 consultas	R$ 4,19
R$ 500/mês até 135 consultas	R$ 3,69
R$ 1.000/mês até 313 consultas	R$ 3,19
R$ 3.000/mês até 1.204 consultas	R$ 2,49
R$ 10.000/mês até 4.566 consultas	R$ 2,19
R$ 20.000/mês até 11.173 consultas	R$ 1,79

O valor é cobrado por consulta, na criação da consulta. Ler o resultado de novo pelo mesmo requestId não gera nova cobrança.

Sem plano, a conta usa o valor Sob demanda e paga só o que consumir.

Comparar planos

Próximos passos

Autenticação

Gere a chave e envie no cabeçalho.

Erros e códigos

Como tratar cada resposta de erro.

Cobrança e reembolso

Quando cobramos e quando o valor volta.

Transportador ANTT (RNTRC)

Situação do transportador no RNTRC e se o veículo está na frota dele, por CPF, CNPJ ou RNTRC.