# API de Histórico Veicular - Introdução Consulte o histórico completo de veículos usando apenas a placa com a API do Consultar Placa. ### O que você pode fazer com nossa API? * Consultar dados básicos e avançados de veículos a partir da placas e chassi. * Obter informações sobre o histórico do veículo como: * **Verificação junto a Base Estadual** (DETRANS) como **Renavam** e Restrições * **Verificação junto ao Registro Nacional** de Infrações de Trânsito (RENAINF) * **Histórico de Roubo e Furto** * **Registro de Ofertas em Leilões Prime (Com Classificação)** * **Registro de Remarketing / Desmobilização de Frota** * **Informações sobre a ocorrência** de sinistros com Perda Total (PT) * **Verificação junto a Base Federal (DENATRAN)** sobre Restrições Financeiras e Judiciais (RENAJUD) * **Referência de Preço (Fipe)** * **Histórico Recall** * **Guia de Imagens** * **Ficha Técnica Comparativa** * **Custo Médio de Manutenção** ### Por que escolher nossa API? * **Confiabilidade:** Dados atualizados e provenientes de fontes confiáveis. * **Facilidade de Integração:** Endpoints bem documentados com suporte ao padrão JSON, garantindo simplicidade na implementação. * **Relatórios Prontos:** Além das respostas em JSON, você pode gerar relatórios completos em PDF para armazenar ou compartilhar informações de maneira profissional. * **Alta Performance:** Processamento rápido, ideal para atender grandes volumes de consultas em tempo real. * **Escalabilidade:** Projetada para crescer junto com as necessidades do seu negócio. Este guia foi preparado para ajudá-lo a integrar nossa API de maneira simples e eficiente, aproveitando ao máximo seus recursos. Caso tenha dúvidas ou precise de suporte, nossa equipe está à disposição para ajudar. **Pronto para começar? Explore nossa documentação e veja como nossa API pode transformar o acesso a dados veiculares no seu negócio!** # Autenticação e teste ### Teste gratuito Para realizar uma simulação, você pode utilizar a placa **AAA0000**.\ Essa placa retornará dados fictícios exclusivamente para testes, permitindo que você explore as funcionalidades da API sem consumir créditos ou acessar informações reais. Para a rota de consulta de chassi, você pode utilizar o chassi **00AAA00A00A000000.** ### Autenticação da API: Basic Auth Todas as rotas da API exigem autenticação via **Basic Auth**. Para acessar os recursos, você deve utilizar o seu **email** como nome de usuário e sua **api\_key** como senha. ### Como obter sua API Key Para gerar sua **API KEY**, acesse ou crie sua conta em nosso site [www.consultarplaca.com.br](https://www.consultarplaca.com.br?utmsource=API_DOCUMENTACAO) seguindos estes estes passos simples: 1. Após acessar nosso site clique em **MINHA CONTA.** 2. Informe seu **e-mail e senha**. Se ainda não tiver uma conta, clique em **Criar Conta / Recuperar Minha Senha** para se cadastrar**.** 3. Após o login, acesse o menu **API**. 4. Clique em **Gerar API KEY** Pronto! Sua **API KEY** será gerada e poderá ser utilizada conforme necessário. 🚀 # Padrões de resposta Todas as rotas da nossa API retornam os dados no formato **JSON**, garantindo uma integração simples e compatível com a maioria das linguagens e frameworks de desenvolvimento. Além disso, seguimos os padrões de código de status HTTP para indicar o resultado de cada requisição, conforme descrito abaixo: * **200 - Sucesso:** A requisição foi processada com êxito e os dados foram retornados no corpo da resposta. * **400 - Erro de Requisição:** Ocorreu um problema com os dados enviados na requisição. Verifique os parâmetros e tente novamente. * **403 - Permissão Negada:** O usuário não possui permissão para acessar o recurso solicitado. Certifique-se de que suas credenciais e permissões estão corretas. * **429 - Limite de Requisições Excedido**: O número máximo de requisições permitidas foi atingido. Para garantir a estabilidade do sistema, cada usuário pode realizar até **120 requisições por minuto**. Se receber este erro, tente aumentar o intervalo entre as requisições. Caso sua demanda exija um limite maior, entre em contato para avaliarmos uma possível ampliação. * **500 - Erro Interno:** Um erro inesperado ocorreu no servidor. Nossa equipe será notificada, mas, caso persista, entre em contato com o suporte. ### Informações complementares #### Campo status Todas as rotas retornaram um campo **status** no corpo da resposta JSON, seguindo o padrão: * **status = "ok"**: Indica que a requisição foi bem-sucedida (**HTTP 200**). * **status = "erro"**: Indica que ocorreu uma falha ao processar a requisição. Essa falha pode ser causada por erros do cliente (**HTTP 400, 403**), falta de crédito (**HTTP 402**), limite de requisições (**HTTP 429**) ou erros do servidor (**HTTP 500**). #### Campo tipo\_do\_erro Algumas respostas incluirão o campo **tipo\_do\_erro**, que fornece informações um direcionamento simples sobre a natureza do problema. Esse campo facilita a identificação e tratamento do caso, sendo os possíveis erros: * placa\_nao\_encontrada ou chassi\_nao\_encontrado: Situação ocorre quando não é possível obter informações para a placa ou chassi. Isso pode acontecer porque a placa realmente não existe ou porque o serviço de consulta está temporariamente indisponível. Recomenda-se verificar se a placa foi digitada corretamente e, se estiver correta, tentar novamente mais tarde. * informacao\_nao\_encontrada: Situação ocorre quando não possuímos a informação para a placa informado. * servico\_indisponivel: Situação em que não foi possível completar a pesquisa. Normalmente em situações que nossos fornecedores encontram-se temporariamente indisponíveis. Recomendamos que repita a requisição novamente em alguns minutos! * credito\_insuficiente: Situação em que o crédito de sua conta é insuficiente para cobrir o valor da consulta em questão. ### Exemplos de erros ```json // Placa informada é inválida. { "status": "erro", "mensagem": "Placa informada é invalida. Placa deve possuir o formato conforme exemplos: AAA9999 ou AAA9A99!", "request": { "placa": "AAA022" } } ``` ```json // Placa não encontrada em nossa base. // Neste caso é retornado o campo tipo_do_erro com o valor placa_nao_encontrada { "status": "erro", "tipo_do_erro": "placa_nao_encontrada", "mensagem": "Não foi possível obter informações para a placa informada. Verifique se o valor está correto. Caso esteja, o serviço pode estar temporariamente indisponível. Por favor, tente novamente mais tarde!", "request": { "placa": "AAA0000" } } ``` ```json // Serviço indisponível. // Neste caso é retornado o campo tipo_do_erro com o valor servico_indisponivel { "status": "erro", "tipo_do_erro": "servico_indisponivel", "mensagem": "Não foi possível completar sua pesquisa. Fornecedores temporariamente indisponíveis. Tente novamente em alguns minutos!", "request": { "placa": "AAA0000" } } ``` # Preço Para utilização da API é necessário **adquirir créditos** diretamente no site do **Consultar Placa.** {% hint style="info" %} Os preços informados são válidos no momento da consulta e estão sujeitos a alteração sem aviso prévio. {% endhint %} ### Relatórios Para geração de relatórios os valores praticados são os mesmos apresentados no site. Abaixo, segue tabela demonstrando o custo por relatório de acordo com os créditos adquiridos.

Tabela de preço final para relatórios completos com aquisição de créditos.

### Consultas Avulsas Para consultas avulsas o valor é reduzido de acordo com o volume mensal de consultas, conforme tabelas abaixo: #### Informações Básicas do Veículo - [Consulta pela Placa](/consultas/consultar-placa) e [Consulta pelo Chassi](/consultas/consultar-chassi)
Volume de Consultas MensalPreço por ConsultaPreço real com desconto do Pacote de Créditos (20%)
1 a 1.000R$ 0,31R$ 0,25
1.001 a 5.000R$ 0,25R$ 0,20
5.001 a 10.000R$ 0,19R$ 0,15
10.001 a 20.000R$ 0,15R$ 0,12
{% hint style="info" %} **Volumes acima de 20.000 consultas/mês** Para aplicações com **alto volume de consultas**, trabalhamos com **condições especiais e valores progressivos**, ajustados conforme o seu cenário de uso. Entre em contato para uma proposta personalizada:

WhatAppou Email

{% endhint %} #### [Renavam](/consultas/renavam)
Volume de Consultas MensalPreço por ConsultaPreço real com desconto do Pacote de Créditos (20%)
1 a 1.000R$ 5,20R$ 4,16
1.001 a 5.000R$ 4,80R$ 3,84
Acima de 5.000R$ 4,40R$ 3,52
#### [Débitos por Infrações (RENAINF)](/consultas/debitos-por-infracoes-renainf)
Volume de Consultas MensalPreço por ConsultaPreço real com desconto do Pacote de Créditos (20%)
1 a 1.000R$ 4,50R$ 3,60
1.001 a 5.000R$ 4,00R$ 3,20
Acima de 5000R$ 3,80R$ 3,04
#### [Proprietário Atual](/consultas/proprietario-atual)
Volume de Consultas MensalPreço por ConsultaPreço real com desconto do Pacote de Créditos (20%)
1 a 1.000R$ 6,90R$ 5,52
1.001 a 5.000R$ 6,50R$ 5,20
Acima de 5.000R$ 6,10R$ 4,88
#### [Preço FIPE](/consultas/consulta-fipe-por-placa)
Volume de Consultas MensalPreço por ConsultaPreço real com desconto do Pacote de Créditos (20%)
1 a 1.000R$ 0,99R$ 0,79
1.001 a 5.000R$ 0,95R$ 0,76
5.001 a 10.000R$ 0,90R$ 0,72
10.001 a 20.000R$ 0,85R$ 0,68
20.001 a 100.000R$ 0,80R$ 0,64
acima de 100.000R$ 0,70R$ 0,56
#### [Registro de oferta de Leilão (Prime)](/consultas/registro-de-ofertas-de-leilao)
Volume de Consultas MensalPreço por ConsultaPreço real com desconto do Pacote de Créditos (20%)
1 a 1.000R$ 16,90R$ 13,52
1.001 a 5.000R$ 16,40R$ 13,12
Acima de 5000R$ 15,90R$ 12,72
#### [Ocorrência de sinistros com Perda Total](/consultas/ocorrencia-de-sinistros-com-perda-total)
Volume de Consultas MensalPreço por ConsultaPreço real com desconto do Pacote de Créditos (20%)
1 a 1.000R$ 4,50R$ 3,60
1.001 a 5.000R$ 4,00R$ 3,20
Acima de 5000R$ 3,80R$ 3,04
#### [Histórico de Roubo e Furto](/consultas/historico-roubo-e-furto)
Volume de Consultas MensalPreço por ConsultaPreço real com desconto do Pacote de Créditos (20%)
1 a 1.000R$ 6,90R$ 5,52
1.001 a 5.000R$ 6,50R$ 5,20
Acima de 5000R$ 6,10R$ 4,88
#### [GRAVAME (Alienação Financeira)](/consultas/gravame-alienacao-financeira)
Volume de Consultas MensalPreço por ConsultaPreço real com desconto do Pacote de Créditos (20%)
1 a 1.000R$ 4,60R$ 3,68
1.001 a 5.000R$ 4,30R$ 3,44
Acima de 5000R$ 4,00R$ 3,20
# Consultar Placa - Informações básicas Retorna dados de um veículo através de sua placa `GET` `https://api.consultarplaca.com.br/v2/consultarPlaca` #### Parâmetros Obrigatórios
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA0000 ou AAA09A00
#### Exemplos de respostas 200 - Consulta realizada com sucesso ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2020-11-22 16:54:10", "dados": { "informacoes_veiculo": { "dados_veiculo": { "placa": "AAA9999", "chassi": "9AAAA99AAAA999999", "ano_fabricacao": "2014", "ano_modelo": "2015", "marca": "HYUNDAI", "modelo": "HYUNDAI/HB20 1.0M COMFOR", "cor": "Branca", "segmento": "Auto", "combustivel": "Álcool / Gasolina", "procedencia": "Nacional", "municipio": "MARINGA", "uf_municipio": "PR" }, "dados_tecnicos": { "tipo_veiculo": "Automovel", "sub_segmento": "AU - HATCH PEQUENO", "numero_motor": "A9AAAA999999", "numero_caixa_cambio": "AA999999999", "potencia": "80", "cilindradas": "998" }, "dados_carga": { "numero_eixos": "2", "capacidade_maxima_tracao": "182", "capacidade_passageiro": "5" } } }, "request": { "placa": "AAA9999" } } ``` # Consultar Chassi - Informações básicas Retorna dados de um veículo através do chassi `GET` `https://api.consultarplaca.com.br/v2/consultarChassi` #### Parâmetros Obrigatórios
NomeTipoDescrição
chassistringChassi do Veículo.
Chassi deve possuir 8 à 17 caracteres alfanuméricos. EX: 00AAA00A00A000000
#### Exemplos de respostas 200 - Consulta realizada com sucesso ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2020-11-22 16:54:10", "dados": { "informacoes_veiculo": { "dados_veiculo": { "placa": "AAA0000", "chassi": "00AAA00A00A000000", "ano_fabricacao": "2014", "ano_modelo": "2015", "marca": "HYUNDAI", "modelo": "HYUNDAI/HB20 1.0M COMFOR", "cor": "Branca", "segmento": "Auto", "combustivel": "Álcool / Gasolina", "procedencia": "Nacional", "municipio": "MARINGA", "uf_municipio": "PR" }, "dados_tecnicos": { "tipo_veiculo": "Automovel", "sub_segmento": "AU - HATCH PEQUENO", "numero_motor": "A9AAAA999999", "numero_caixa_cambio": "AA999999999", "potencia": "80", "cilindradas": "998" }, "dados_carga": { "numero_eixos": "2", "capacidade_maxima_tracao": "182", "capacidade_passageiro": "5" } } }, "request": { "chassi": "00AAA00A00A000000" } } ``` # Renavam Retorna RENAVAM do veículo, juntamente com informações básicas do veículo `GET` `https://api.consultarplaca.com.br/v2/consultarRenavam` #### Parâmetros Obrigatórios
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA0000 ou AAA09A00
#### Exemplos de respostas 200 - Consulta realizada com sucesso ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2020-11-22 16:54:10", "dados": { "informacoes_veiculo": { "dados_veiculo": { "placa": "AAA9999", "chassi": "9AAAA99AAAA999999", "ano_fabricacao": "2014", "ano_modelo": "2015", "marca": "HYUNDAI", "modelo": "HYUNDAI/HB20 1.0M COMFOR", "cor": "Branca", "segmento": "Auto", "combustivel": "Álcool / Gasolina", "procedencia": "Nacional", "municipio": "MARINGA", "uf_municipio": "PR", "renavam": "9999999999" }, "dados_tecnicos": { "tipo_veiculo": "Automovel", "sub_segmento": "AU - HATCH PEQUENO", "numero_motor": "A9AAAA999999", "numero_caixa_cambio": "AA999999999", "potencia": "80", "cilindradas": "998" }, "dados_carga": { "numero_eixos": "2", "capacidade_maxima_tracao": "182", "capacidade_passageiro": "5" } } }, "request": { "placa": "AAA9999" } } ``` # Débitos por Infrações (RENAINF) Retorna informações sobre registros de débitos por infrações (RENAINF). `GET` `https://api.consultarplaca.com.br/v2/consultarRegistrosInfracoesRenainf` {% hint style="info" %} **IMPORTANTE**: São retornadas apenas infrações que: * **Estão em aberto no sistema do órgão autuador**, podendo ou não já terem sido pagas. A confirmação de pagamento deve ser realizada diretamente junto ao órgão responsável. * **Já foram executadas**, ou seja, o prazo para recurso foi encerrado e a multa foi efetivamente emitida (boleto gerado).
{% endhint %} #### Parâmetros Obrigatórios
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA9999 ou AAA9A99
#### Exemplos de respostas 200 - Quando veículo POSSUI registro de infrações ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2021-09-16 22:25:54", "dados": { "registro_debitos_por_infracoes_renainf": { "infracoes_renainf": { "possui_infracoes": "sim", "infracoes": [ { "dados_infracao": { "infracao": "7455 - TRANSITAR EM ATE 20% ACIMA DA VELOCIDADE PERMITIDA", "numero_auto_infracao": "R400009999", "valor_aplicado": "130,16", "orgao_autuador": "100 - POLICIA RODOVIARIA FEDERAL", "tipo_auto_infracao": "2", "local_infracao": "BR 163 KM 270 UF MS", "municipio": "DOURADOS" }, "aplicacao": { "unidade_medida": "KM/H", "limite_permitido": "60,00", "medicao_considerada": "0,00", "medicao_real": "69,00" }, "eventos": { "data_hora_infracao": "08/02/2019 ", "data_cadastramento": "01/03/2019", "data_notificacao": "", "data_emissao_penalidade": "" } } ] } } }, "request": { "placa": "AAA9999" } } ``` 200 - Quando NÃO possui registro de infrações ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2021-09-16 22:10:48", "dados": { "registro_debitos_por_infracoes_renainf": { "infracoes_renainf": { "possui_infracoes": "nao", "infracoes": [] } } }, "request": { "placa": "AAA9999" } } ``` # Proprietário atual Retorna informações sobre o proprietário atual do veículo. `GET` `https://api.consultarplaca.com.br/v2/consultarProprietarioAtual` {% hint style="info" %} **IMPORTANTE**: Consulta não permite identificação de pessoas físicas. Apenas primeiro nome e início do documento são apresentados {% endhint %} #### Parâmetros Obrigatórios
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA9999 ou AAA9A99
#### Exemplos de respostas 200 - Proprietário atual retornado ```json { "status": "ok", "mensagem": "Consulta EXEMPLO realizada com sucesso!", "data_solicitacao": "2025-04-18 12:28:56", "dados": { "proprietario_atual": { "nome": "JOSE", "documento": "99********9", "tipo_documento": "FISICA" } }, "request": { "placa": "AAA0000" } } ``` # Preço FIPE Consulta o preço FIPE de um veículo a partir da placa, exibindo o valor atual e a variação histórica dos últimos 12 meses. `GET` `https://api.consultarplaca.com.br/v2/consultarPrecoFipe` #### Parâmetros Obrigatórios
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA9999 ou AAA9A99
#### Exemplos de respostas 200 - Preço FIPE localizado ```json // Exemplo de consulta realizada em Abril de 2025 { "status": "ok", "mensagem": "Consulta EXEMPLO realizada com sucesso!", "data_solicitacao": "2025-05-01 15:57:51", "dados": { "informacoes_veiculo": { "dados_veiculo": { "placa": "AAA0000", "chassi": "0AAAA00AAAA000000", "ano_frabricacao": "2014", "ano_modelo": "2015", "marca": "HYUNDAI", "modelo": "HB20 1.0M COMFOR", "cor": "Branca", "segmento": "Auto", "combustivel": "Alcool / Gasolina", "procedencia": "Nacional", "municipio": "MARINGA", "uf_municipio": "PR" }, "dados_tecnicos": { "tipo_veiculo": "Automovel", "sub_segmento": "AU - HATCH PEQUENO", "numero_motor": "F3LAEU240650", "numero_caixa_cambio": "HA140792745", "potencia": "80", "cilindradas": "998" }, "dados_carga": { "numero_eixos": "2", "capacidade_maxima_tracao": "182", "capacidade_passageiro": "5", "peso_bruto_total": "142" } }, "informacoes_fipe": [ { "codigo_fipe": "015099-1", "modelo_versao": "HB20S C.Plus/C.Style1.0 Flex 12V Mec. 4P", "preco": "43208.00", "mes_referencia": "2025_04", "historico": { "2024_05": "45989.00", "2024_06": "44543.00", "2024_07": "44166.00", "2024_08": "44033.00", "2024_09": "43823.00", "2024_10": "43624.00", "2024_11": "43553.00", "2024_12": "43031.00", "2025_01": "42815.00", "2025_02": "42975.00", "2025_03": "43052.00", "2025_04": "43208.00" } }, { "codigo_fipe": "015116-5", "modelo_versao": "HB20S For You 1.0 Flex 12V 4p", "preco": "40634.00", "mes_referencia": "2025_04", "historico": { "2024_05": "45155.00", "2024_06": "43574.00", "2024_07": "42048.00", "2024_08": "41316.00", "2024_09": "41061.00", "2024_10": "39623.00", "2024_11": "38944.00", "2024_12": "37580.00", "2025_01": "36941.00", "2025_02": "38233.00", "2025_03": "39571.00", "2025_04": "40634.00" } }, { "codigo_fipe": "015109-2", "modelo_versao": "HB20 Copa do Mundo 1.0 Flex 12V Mec.", "preco": "41515.00", "mes_referencia": "2025_04", "historico": { "2024_05": "43877.00", "2024_06": "43579.00", "2024_07": "43361.00", "2024_08": "43103.00", "2024_09": "42839.00", "2024_10": "42624.00", "2024_11": "42570.00", "2024_12": "42357.00", "2025_01": "42145.00", "2025_02": "41934.00", "2025_03": "41724.00", "2025_04": "41515.00" } }, { "codigo_fipe": "015115-7", "modelo_versao": "HB20 For You 1.0 Flex 12V 5p", "preco": "40803.00", "mes_referencia": "2025_04", "historico": { "2024_05": "43001.00", "2024_06": "41785.00", "2024_07": "41432.00", "2024_08": "41953.00", "2024_09": "41421.00", "2024_10": "41456.00", "2024_11": "41024.00", "2024_12": "41375.00", "2025_01": "40819.00", "2025_02": "41761.00", "2025_03": "40927.00", "2025_04": "40803.00" } }, { "codigo_fipe": "015112-2", "modelo_versao": "HB20S Copa do Mundo 1.0 Flex 12V Mec.", "preco": "43834.00", "mes_referencia": "2025_04", "historico": { "2024_05": "46231.00", "2024_06": "46258.00", "2024_07": "46035.00", "2024_08": "46843.00", "2024_09": "45264.00", "2024_10": "45426.00", "2024_11": "43996.00", "2024_12": "43468.00", "2025_01": "43250.00", "2025_02": "43596.00", "2025_03": "43675.00", "2025_04": "43834.00" } } ] }, "request": { "placa": "AAA0000" } } ``` # Registro de oferta de Leilão (Prime) Registro de Ofertas em Leilões Prime (Com Classificação) `GET` `https://api.consultarplaca.com.br/v2/consultarRegistroLeilaoPrime` #### Parâmetros Obrigatórios
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA9999 ou AAA9A99
{% hint style="info" %} Quando há uma oferta de leilão, o processamento de imagens pode aumentar significativamente o tempo necessário para responder à requisição. Por isso, recomendamos configurar um **connection timeout** maior, com um valor mínimo de **300 segundos**, para evitar interrupções durante o processamento. {% endhint %} #### Exemplos de respostas 200 - Quando veículo POSSUI registro de infrações ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2025-02-16 10:02:05", "dados": { "informacoes_sobre_leilao": { "possui_registro": "sim", /* Valores: sim, nao, indisponivel */ "registro_sobre_oferta": { "classificacao": "C", /* Valores: A, B, C, D e N, 'Vazio' quando negativo */ "dicionario_classificacoes": { "A": { "titulo": "Sem dano (Financeira / Bancos)", "descricao": "Veículos com boa lataria e mecânica funcionando no ato do leilão, os principais motivos destes leilões são:\nVeículos recuperados de financiamento onde o comprador não conseguiu pagar todo o financiamento e entregou o carro para o Banco como parte da garantia.\nVeículos de empresas particulares a empresa leiloa o veículo antigo por um preço menor que o mercado para fazer dinheiro mais rápido.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo." }, "B": { "titulo": "Judicial (Financeira / Bancos)", "descricao": "Veículos com lataria danificada até 2 peças como para-lamas, farol, vidros, entre outros, mecânica funcionando no ato do leilão, os principais motivos destes leilões são:\nVeículos recuperados de financiamento onde o comprador não conseguiu pagar todo o financiamento e entregou o carro para o Banco como parte da garantia.\nVeículos de empresas particulares a empresa leiloa o veículo antigo por um preço menor que o mercado para fazer dinheiro mais rápido.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo." }, "C": { "titulo": "(Seguradoras / Detrans / Ciretrans / Receita federal)", "descricao": "Veículos com lataria danificada acima de 2 peças como para-lamas, farol, vidros e mecânica funcionando em alguns casos no ato do leilão, os principais motivos destes leilões são:\nVeículos que sofreram uma (batida, choque, quebra, outro prejuízo material) onde o conserto do veículo foi superior a 75% do valor do veículo de acordo com a seguradora onde a seguradora está vendendo para repor parte do dinheiro que ela pagou ao segurado.\nVeículos recuperados de Roubo e Furto onde a seguradora já indenizou o segurado vão para leilão para seguradora repor parte do dinheiro que pagou para o segurado.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo." }, "D": { "titulo": "(Danificado / Financeiras / Bancos / Seguradoras)", "descricao": "Veículos com lataria danificada onde não foi possível estimar com precisão quais os danos que o veículo sofreu e mecânica não funcionando no ato do leilão os principais motivos destes leilões são:\nVeículos que sofreram uma (batida, choque, quebra, outro prejuízo material) onde o conserto do veículo foi superior a 75% do valor do veículo de acordo com a seguradora onde a seguradora está vendendo para repor parte do dinheiro que ela pagou ao segurado.\nVeículos recuperados de Roubo e Furto onde a seguradora já indenizou o segurado vão para leilão para seguradora repor parte do dinheiro que pagou para o segurado." } } }, "registro_leiloes": { "registros": [ { "comitente": "", "lote": "2209", "data_leilao": "09/11/2021", "placa": "QOQ8E36", "classi": "9AAAA99AAAA999999", "renavam": "", "ano_fabricacao": "2018", "ano_modelo": "", "segmento": "", "sub_segmento": "", "numero_motor": "" }, { "comitente": "HDI SEGUROS", "lote": "148", "data_leilao": "09/11/2021", "placa": "QOQ8436", "classi": "9AAAA99AAAA999999", "renavam": "00000000000", "ano_fabricacao": "2018", "ano_modelo": "", "segmento": "AUTO", "sub_segmento": "AU - SEDAN PEQUENO", "numero_motor": "F4FAJU184925" } ] }, "registro_sinistros_acidentes": { "possui_registro": "nao" /* Valores: sim, nao, indisponivel */ }, "parecer_tecnico": { "parecer": "favoravel", /* Valores: favoravel, desfavoravel, alerta */ "detalhes": { "registro_vistorias_negadas": "nao", /* Valores: sim, nao, indisponivel */ "registro_frota_locadora": "nao", /* Valores: sim, nao, indisponivel */ "registro_indicios_acidentes": "indisponivel", /* Valores: sim, nao, indisponivel */ "registro_veiculo_importado": "nao" /* Valores: sim, nao, indisponivel */ } } }, "informacoes_sobre_remarketing": { "possui_registro": "sim", /* Valores: sim, nao, indisponivel */ "registros": [ { "item": "26", "organizador": "NomeOrganizador", "data_evento": "16/11/2016", "condicao_geral_veiculo": "", "condicao_motor": "", "condicao_cambio": "" } ], "fotos": [ "https://api.consultarplaca.com.br/images/remarketing?token=EXEMPLO", "https://api.consultarplaca.com.br/images/remarketing?token=EXEMPLO", ] }, "informacoes_possiveis_danos_detectados_por_ia": { "situacao_analise": "concluido", /* Valores: concluido, indisponivel, processando */ "possiveis_dados": [ { "local": "Capô", "descricao": "Pequenos arranhões na pintura", "probabilidade": 41 }, { "local": "Para brisa dianteiro", "descricao": "Amassados médios", "probabilidade": 46 }, { "local": "Capô", "descricao": "Amassados severos", "probabilidade": 65 } ], "possiveis_pecas_danificadas": [ { "descricao": "Forro do capô", "probabilidade": 100 }, { "descricao": "Capô", "probabilidade": 100 }, { "descricao": "Tinta e acabamento", "probabilidade": 100 }, { "descricao": "Parafusos e fixadores do capô", "probabilidade": 80 }, { "descricao": "Amortecedores do capô", "probabilidade": 70 }, { "descricao": "Borracha de vedação do capô", "probabilidade": 70 } ], "imagens": [ "https://api.consultarplaca.com.br/images/leilaoPrimeIA?token=7SngiZ23kBRSfoAfJUxMlh7FXcnplSLLNeRinsqnZK6wnbax6LUihy4hSACur4_2ShbM1BII4bVp_AN4XsD-FG74tFRT-VsM7o7qbmU65fECtqMpgYFVvQY3YNR1AF-XcPBmt7lS18ZBqeB5sIjuAaE", "https://api.consultarplaca.com.br/images/leilaoPrimeIA?token=34Oor1KIX_7NBJRU0MBrlc9Nzyt6dh4u8Ck45q1H3QyudrCX-oUfdF4tL9MK6q4MUzbum5a9R_Ns8aPoNGmCXr1TWjYTcsdL9htnMeDNqT7LuNUpVtNGrhi59SmBDFqneUYFlUqYv0s9QYyXG8pYbIk", "https://api.consultarplaca.com.br/images/leilaoPrimeIA?token=O4ylXjWTSiq9Iu2CkO3CoJ13fUQynA2WJK5z7a4xurXigpTd3CDL1bAEeoQLLymC-As38kkQsy5o-RCekd_GhsGPYZT8QNeHU9LIPSH3DW7KarNsluordHqbfIGxUffXgnShNnutpw7HI2u0KCuHsGJHFA", "https://api.consultarplaca.com.br/images/leilaoPrimeIA?token=fnTOHkikWkWmKPXxPIkbWnMjExFBqV9Ile0NBVCx9x4-PISaPF4Uris5poDpTJURLklNEXvoaRt_aOSqBxM8BEcyq7_TkV5yv76qPEwzC1erHVnkdFoLNSdXDsnnqFxGbuns9AVFHKXu-7X8xS-bkEc" ] } }, "request": { "placa": "AAA9999" } } ``` 200 - Quando NÃO possui registro de leilão ```json { "status":"ok", "mensagem":"Consulta realizada com sucesso!", "data_solicitacao":"2025-01-01 01:00:00", "dados":{ "informacoes_sobre_leilao":{ "possui_registro":"nao", "registro_sobre_oferta":{ "classificacao":"", "dicionario_classificacoes":{ "A":{ "titulo":"Sem dano (Financeira \/ Bancos)", "descricao":"Veículos com boa lataria e mecânica funcionando no ato do leilão, os principais motivos destes leilões são:\nVeículos recuperados de financiamento onde o comprador não conseguiu pagar todo o financiamento e entregou o carro para o Banco como parte da garantia.\nVeículos de empresas particulares a empresa leiloa o veículo antigo por um preço menor que o mercado para fazer dinheiro mais rápido.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo." }, "B":{ "titulo":"Judicial (Financeira \/ Bancos)", "descricao":"Veículos com lataria danificada até 2 peças como para-lamas, farol, vidros, entre outros, mecânica funcionando no ato do leilão, os principais motivos destes leilões são:\nVeículos recuperados de financiamento onde o comprador não conseguiu pagar todo o financiamento e entregou o carro para o Banco como parte da garantia.\nVeículos de empresas particulares a empresa leiloa o veículo antigo por um preço menor que o mercado para fazer dinheiro mais rápido.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo." }, "C":{ "titulo":"(Seguradoras \/ Detrans \/ Ciretrans \/ Receita federal)", "descricao":"Veículos com lataria danificada acima de 2 peças como para-lamas, farol, vidros e mecânica funcionando em alguns casos no ato do leilão, os principais motivos destes leilões são:\nVeículos que sofreram uma (batida, choque, quebra, outro prejuízo material) onde o conserto do veículo foi superior a 75% do valor do veículo de acordo com a seguradora onde a seguradora está vendendo para repor parte do dinheiro que ela pagou ao segurado.\nVeículos recuperados de Roubo e Furto onde a seguradora já indenizou o segurado vão para leilão para seguradora repor parte do dinheiro que pagou para o segurado.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo." }, "D":{ "titulo":"(Danificado \/ Financeiras \/ Bancos \/ Seguradoras)", "descricao":"Veículos com lataria danificada onde não foi possível estimar com precisão quais os danos que o veículo sofreu e mecânica não funcionando no ato do leilão os principais motivos destes leilões são:\nVeículos que sofreram uma (batida, choque, quebra, outro prejuízo material) onde o conserto do veículo foi superior a 75% do valor do veículo de acordo com a seguradora onde a seguradora está vendendo para repor parte do dinheiro que ela pagou ao segurado.\nVeículos recuperados de Roubo e Furto onde a seguradora já indenizou o segurado vão para leilão para seguradora repor parte do dinheiro que pagou para o segurado." } } }, "registro_leiloes":{ "registros":[] }, "registro_sinistros_acidentes":{ "possui_registro":"nao" }, "parecer_tecnico":{ "parecer":"favoravel", "detalhes":{ "registro_vistorias_negadas":"nao", "registro_frota_locadora":"nao", "registro_indicios_acidentes":"nao", "registro_veiculo_importado":"nao" } } }, "informacoes_sobre_remarketing":{ "possui_registro":"nao", "registros":null, "fotos":null }, "informacoes_possiveis_danos_detectados_por_ia":{ "situacao_analise":"indisponivel", "possiveis_dados":null, "possiveis_pecas_danificadas":null, "imagens":null } }, "request":{ "placa":"AAA9999" } } ``` # Ocorrência de sinistros com Perda Total Registro de sinistros com Perda Total `GET` `https://api.consultarplaca.com.br/v2/consultarSinistroComPerdaTotal` #### Parâmetros Obrigatórios
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA9999 ou AAA9A99
#### Exemplos de respostas 200 - Quando veículo POSSUI registro de sinistro com perda total ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2025-09-08 08:18:57", "dados": { "registro_sinistro_com_perda_total": { "possui_registro": "sim", "registro": "CONSTA INDENIZAÇÃO INTEGRAL" } }, "request": { "placa": "AAA0000" } } ``` 200 - Quando NÃO possui ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2025-09-08 08:18:57", "dados": { "registro_sinistro_com_perda_total": { "possui_registro": "nao", "registro": "" } }, "request": { "placa": "AAA0000" } } ``` 200 - Quando resultado não esta disponível ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2025-09-08 08:18:57", "dados": { "registro_sinistro_com_perda_total": { "possui_registro": "indisponivel", "registro": "" } }, "request": { "placa": "AAA0000" } } ``` # Histórico de Roubo Furto Retorna o Histórico de Roubo Furto de um veículo através de sua placa `GET` `https://api.consultarplaca.com.br/v2/consultarHistoricoRouboFurto` #### Parâmetros Obrigatórios
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA9999 ou AAA9A99
#### Exemplos de respostas 200 - Quando veículo POSSUI histórico de roubo e furto ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2026-01-24 14:30:00", "dados": { "historico_roubo_furto": { "registros_roubo_furto": { "possui_registro": "sim", "registros": [ { "boletim_ocorrencia": "9996", "data_boletim_ocorrencia": "02/09/2019", "tipo_ocorrencia": "Declaração de Roubo", "uf_ocorrencia": "PR" }, { "boletim_ocorrencia": "9997", "data_boletim_ocorrencia": "05/09/2019", "tipo_ocorrencia": "Achado", "uf_ocorrencia": "PR" }, { "boletim_ocorrencia": "9998", "data_boletim_ocorrencia": "06/09/2019", "tipo_ocorrencia": "Devolvido", "uf_ocorrencia": "PR" } ] } } }, "request": { "placa": "AAA0000" } } ``` 200 - Quando NÃO possui ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2026-01-24 14:30:30", "dados": { "historico_roubo_furto": { "registros_roubo_furto": { "possui_registro": "nao", "registros": [] } } }, "request": { "placa": "AAA0000" } } ``` 200 - Quando resultado não esta disponível ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2026-01-24 14:30:30", "dados": { "historico_roubo_furto": { "registros_roubo_furto": { "possui_registro": "indisponivel", "registros": [] } } }, "request": { "placa": "AAA0000" } } ``` # GRAVAME (Alienação Financeira) Retorna se o veículo possui GRAVAME (Alienação Financeira) ativo `GET` `https://api.consultarplaca.com.br/v2/consultarGravame` #### Parâmetros Obrigatórios
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA0000 ou AAA0A00
#### Exemplos de respostas 200 - Quando veículo POSSUI GRAVAME Ativo ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2026-01-30 13:23:47", "dados": { "gravame": { "possui_gravame": "sim", "registro": { "agente_financeiro": { "cnpj": "90400888000142", "nome": "BANCO SANTANDER SA" }, "data_registro": "07/07/2022", "placa": "AAA0000", "chassi": "00AAA00A00A000000", "uf_placa": "SP", "situacao": "CONSTA REGISTRO DE GRAVAME" } } }, "request": { "placa": "AAA0000" } } ``` 200 - Quando NÃO possui ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2026-01-30 13:30:43", "dados": { "gravame": { "possui_gravame": "nao", "registro": null } }, "request": { "placa": "AYX2416" } } ``` 200 - Quando resultado não esta disponível ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso!", "data_solicitacao": "2026-01-30 13:30:43", "dados": { "gravame": { "possui_gravame": "indisponivel", "registro": null } }, "request": { "placa": "AYX2416" } } ``` # Solicitar Relatório / Histórico Registra solicitação de geração de relatório / histórico de um veículo. Este endpoint retorna um **protocolo único**, que pode ser utilizado para realizar consultas detalhadas no endpoint [/v2/consultarProtocolo](/relatorios/consultar-relatorio-historico). A partir desse protocolo, você poderá obter os dados da consulta no formato **JSON** para manipulação em seu sistema ou diretamente em **PDF**, pronto para download e compartilhamento. > PDF também podem ser gerado já com identidade visual da sua marca (cor, logo e seu site). para isso necessário previamente se habilitar como revendedor junto a nossa equipe. `POST` `https://api.consultarplaca.com.br/v2/solicitarRelatorio` #### Request Body {% hint style="info" %} **Importante:** As requisições `POST` devem utilizar o `Content-Type: multipart/form-data`.\ Certifique-se de enviar os parâmetros no corpo da requisição como `form-data`. {% endhint %}
NomeTipoDescrição
placastringPlaca do Veículo.
Placa deve possuir os seguintes formatos: AAA9999 ou AAA9A99
tipo_consultastringTipo da consulta. Valores possíveis:
- bronze
- prata
- ouro
- diamante
- personalizada

Para opção personalizada o campo informacoes_adicionais é obrigatório.
url_notificacaostringURL para onde será enviado a notificação quando a consulta estiver pronta. Quando enviado este parâmetro assim que finalizado o processamento do relatório uma notificação POST será enviada com um formato JSON conforme exemplo abaixo:
{
"protocolo":"ABCDEF",
"dados":{
"url_pdf":"http://app.consultarpla...."
}
}
consulta_para_revendabooleanIdentificação se o relatório deve ou não ser gerado no formato de revenda.
1 para SIM. Neste caso o relatório será gerado com a logo, cor e endereço do site do revendedor.
0 para NÃO. Neste caso o relatório é gerado com a identidade visual do Consultar Placa.

O valor padrão deste campo é 0 (NÃO).
* Para gerar relatório como revenda é necessário credenciar sua conta junto a nossa equipe.
informacoes_adicionaisString

Informações adicionais que devem ser inclusas no relatório. Para mais de um adicional passar os valores separados por vírgula. (Ex: 3, 4, 1). Valores Possíveis:
1 = Informações sobre a ocorrência de sinistros com Perda Total (PT)

3 = Registro de Ofertas em Leilões PRIME (Verifica leilões Corporativo, Privado e Varejo )

4 = Histórico de Roubo e Furto

5 = Verificação junto a Base Federal (DENATRAN) sobre Restrições Financeiras e Judiciais (RENAJUD)
7 = Verificação junto a Base Estadual
(DETRANS) como Renavam e Restrições)

8 = Informações gerais sobre o veículo (Chassi, Marca/Modelo, Ano Modelo ...)

10 = GRAVAME (Alienação Financeira)

13 = Registro de Ofertas em Leilões Simples (NÃO verifica Leilões Corporativo, Privado e Varejo )
17 = Verificação junto ao Registro Nacional de Infrações de Trânsito (RENAINF)

18 = Recall

19 = Guia de Imagens (NÃO necessariamente imagens do veículo consultado)

23 = Ficha Técnica Comparativa
24 = Custo Médio de Manutenção
25 = Proprietário atual do veículo (Exibe apenas o primeiro nome e os dígitos iniciais do documento, sem identificar a pessoa).

27 = Referência de Preço (Fipe)

Caso seja enviado algum adicional inválido, ou que já esteja contido no tipo de consulta solicitado o mesmo será ignorado.

#### Exemplos de respostas 200 - Consulta solicitada com sucesso ```json { "status": "ok", "mensagem": "Consulta solicitada com sucesso!", "data_solicitacao": "2019-08-25 16:51:24", "protocolo": "XXXXXXXXXXXXXXX", "link_resultado": "https://api.consultarplaca.com.br/v2/consultarProtocolo?protocolo=XXXXXXXXXXXXXXX", "request": [ "placa": "AAA9999", "tipo_consulta": "basica" ] } ``` # Consultar Relatório / Histórico Retorna resultado e uma solicitação de relatório /histórico através de um protocol `GET` `https://api.consultarplaca.com.br/v2/consultarProtocolo` Retorna o resultado da consulta de uma placa previamente registrada através da rota [/v2/solicitarRelatorio](/relatorios/solicitar-relatorio-historico)**.** Os dados podem ser solicitados nos formatos de PDF ou JSON. #### Parâmetros
NomeTipoDescrição
protocolo*stringProtocolo retornado no momento do registro da consulta (Rota /v2/solicitarRelatorio)
tipo_retornostringFormato que os dados serão retornados. Valores possíveis:
- PDF
- JSON

Caso o tipo do retorno não seja informado o formato padrão será o de PDF
#### Exemplos de respostas Requisição realizada com sucesso. \ Situação de uma consulta (campo **situacao\_consulta**) pode possuir o seguintes valores: * **em\_processamento**: Processamento dos dados ainda não está finalizado. * **parcialmente\_finalizada**: Uma versão parcial está disponível. Situação ocorre quando alguma informação ainda não foi disponibilizada. * **finalizada**: Consulta finaliza e disponível para download. ```json // Exemplo em processamento { "status": "ok", "mensagem": "Consulta em processamento.", "situacao_consulta": "em_processamento", "sobre_os_dados": "As informações retornadas nesta consulta, visam exclusivamente COLABORAR com o processo de averiguação de procedência do veículo, servindo apenas como uma ferramenta de ANÁLISE PRÉVIA e não como elemento de decisão para comercialização do veículo. As informações retornadas nesta pesquisa são as que se encontram disponíveis na data e hora da consulta às bases, sites e pacotes de dados ora contratados e somente será utiliza único e exclusivamente por mim CONTRATANTE sabendo que estou vedado da divulgação da mesma para terceiros, e isento o Consultar Placa de toda e qualquer responsabilidade caso haja divergência de informação, informo ainda que utilizo a consulta para fins estatísticos e tenho conhecimento que existem casos de não informado e divergências em relação às bases on-lines, podendo os registros serem apagados ou apresentarem divergências ou ainda possuírem informações incompletas ou excluídas, como por exemplo apontamentos de registros de leilão, sinistro e demais informações históricas, que podem ser alteradas, baixadas, excluídas e/ou não informadas.", "dados": [], "request": { "protocolo": "ABCDEFG" } } ``` ```json // Exemplo de retorno parcialmente_finalizado (Tipo retorno PDF) { "status": "ok", "mensagem": "Consulta realizada com sucesso.", "situacao_consulta": "parcialmente_finalizada", "protocolo": "ABCDEFG", "sobre_os_dados": "As informações retornadas nesta consulta, visam exclusivamente COLABORAR com o processo de averiguação de procedência do veículo, servindo apenas como uma ferramenta de ANÁLISE PRÉVIA e não como elemento de decisão para comercialização do veículo. As informações retornadas nesta pesquisa são as que se encontram disponíveis na data e hora da consulta às bases, sites e pacotes de dados ora contratados e somente será utiliza único e exclusivamente por mim CONTRATANTE sabendo que estou vedado da divulgação da mesma para terceiros, e isento o Consultar Placa de toda e qualquer responsabilidade caso haja divergência de informação, informo ainda que utilizo a consulta para fins estatísticos e tenho conhecimento que existem casos de não informado e divergências em relação às bases on-lines, podendo os registros serem apagados ou apresentarem divergências ou ainda possuírem informações incompletas ou excluídas, como por exemplo apontamentos de registros de leilão, sinistro e demais informações históricas, que podem ser alteradas, baixadas, excluídas e/ou não informadas.", "dados": { "url_pdf": "https://app.consultarplaca.com.br/cp/d/XXXXXXXXXXXXX" }, "request": { "protocolo": "ABCDEFG" } } ``` ```json // Exemplo de retorno finalizado (Tipo retorno PDF) { "status": "ok", "mensagem": "Consulta realizada com sucesso.", "situacao_consulta": "finalizada", "protocolo": "ABCDEFG", "sobre_os_dados": "As informações retornadas nesta consulta, visam exclusivamente COLABORAR com o processo de averiguação de procedência do veículo, servindo apenas como uma ferramenta de ANÁLISE PRÉVIA e não como elemento de decisão para comercialização do veículo. As informações retornadas nesta pesquisa são as que se encontram disponíveis na data e hora da consulta às bases, sites e pacotes de dados ora contratados e somente será utiliza único e exclusivamente por mim CONTRATANTE sabendo que estou vedado da divulgação da mesma para terceiros, e isento o Consultar Placa de toda e qualquer responsabilidade caso haja divergência de informação, informo ainda que utilizo a consulta para fins estatísticos e tenho conhecimento que existem casos de não informado e divergências em relação às bases on-lines, podendo os registros serem apagados ou apresentarem divergências ou ainda possuírem informações incompletas ou excluídas, como por exemplo apontamentos de registros de leilão, sinistro e demais informações históricas, que podem ser alteradas, baixadas, excluídas e/ou não informadas.", "dados": { "url_pdf": "https://app.consultarplaca.com.br/cp/d/XXXXXXXXXXXXX" }, "request": { "protocolo": "ABCDEFG" } } ``` No exemplo abaixo são apresentadas todas as informações disponíveis nos relatórios Diamante, demais relatórios retornarão apenas informações cobertas pelos modelos em questão. Veja [aqui](https://www.consultarplaca.com.br/#precos) a diferença entre os relatórios. ```json { "status": "ok", "mensagem": "Consulta realizada com sucesso.", "situacao_consulta": "finalizada", "protocolo": "xxxxxxxxxxxx", "sobre_os_dados": "As informações retornadas nesta consulta, visam exclusivamente COLABORAR com o processo de averiguação de procedência do veículo, servindo apenas como uma ferramenta de ANÁLISE PRÉVIA e não como elemento de decisão para comercialização do veículo. As informações retornadas nesta pesquisa são as que se encontram disponíveis na data e hora da consulta às bases, sites e pacotes de dados ora contratados e somente será utiliza único e exclusivamente por mim CONTRATANTE sabendo que estou vedado da divulgação da mesma para terceiros, e isento o Consultar Placa de toda e qualquer responsabilidade caso haja divergência de informação, informo ainda que utilizo a consulta para fins estatísticos e tenho conhecimento que existem casos de não informado e divergências em relação às bases on-lines, podendo os registros serem apagados ou apresentarem divergências ou ainda possuírem informações incompletas ou excluídas, como por exemplo apontamentos de registros de leilão, sinistro e demais informações históricas, que podem ser alteradas, baixadas, excluídas e/ou não informadas.", "dados": [ /* Informações gerais (Chassi, N° Motor, Marca, Modelo e Ano) */ { "informacoes_veiculo": { "dados_veiculo": { "placa": "AAA9999", "chassi": "9AAAA99A1AA999999", "ano_fabricacao": "2014", "ano_modelo": "2014", "marca": "VW", "modelo": "NOVA SAVEIRO CE CROSS", "cor": "PRETA", "segmento": "Comercial Leve", "combustivel": "ALCOOL/GASOLINA", "procedencia": "NACIONAL", "municipio": "GOIANIA", "uf_municipio": "GO" }, "dados_tecnicos": { "tipo_veiculo": "CAMINHONETE", "sub_segmento": "CL - PICK-UP PEQUENA", "numero_motor": "CCRR75774", "numero_caixa_cambio": null, "potencia": "104", "cilindradas": "1598" }, "dados_carga": { "numero_eixos": "2", "capacidade_maxima_tracao": "213", "capacidade_passageiro": "2", "peso_bruto_total": "173" } } }, /* Registro de Ofertas em Leilões Prime (Com Classificação) */ { "informacoes_sobre_leilao": { "possui_registro": "sim", "registro_sobre_oferta": { "classificacao": "D", "dicionario_classificacoes": { "A": { "titulo": "Sem Avarias", "descricao": "Veículos com boa lataria e mecânica funcionando no ato do leilão, os principais motivos destes leilões são:\nVeículos recuperados de financiamento onde o comprador não conseguiu pagar todo o financiamento e entregou o carro para o Banco como parte da garantia.\nVeiculos de empresas particulares a empresa leiloa o veículo antigo por um preço menor que o mercado para fazer dinheiro mais rápido.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo." }, "B": { "titulo": "Avarias leves", "descricao": "Veículos com lataria danificada até 2 peças como para-lamas, farol, vidros, entre outros, mecânica funcionando no ato do leilão, os principais motivos destes leilões são:\nVeículos recuperados de financiamento onde o comprador não conseguiu pagar todo o financiamento e entregou o carro para o Banco como parte da garantia.\nVeiculos de empresas particulares a empresa leiloa o veículo antigo por um preço menor que o mercado para fazer dinheiro mais rápido.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo." }, "C": { "titulo": "Avarias médias", "descricao": "Veículos com lataria danificada acima de 2 peças como para-lamas, farol, vidros e mecânica funcionando em alguns casos no ato do leilão, os principais motivos destes leilões são:\nVeículos que sofreram uma (batida, choque, quebra, outro prejuízo material) onde o conserto do veículo foi superior a 75% do valor do veículo de acordo com a seguradora onde a seguradora está vendendo para repor parte do dinheiro que ela pagou ao segurado.\nVeículos recuperados de Roubo e Furto onde a seguradora já indenizou o segurado vão para leilão para seguradora repor parte do dinheiro que pagou para o segurado.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo." }, "D": { "titulo": "Avarias graves", "descricao": "Veículos com lataria danificada onde não foi possível estimar com precisão quais os danos que o veículo sofreu e mecânica não funcionando no ato do leilão os principais motivos destes leilões são:\nVeículos que sofreram uma (batida, choque, quebra, outro prejuízo material) onde o conserto do veículo foi superior a 75% do valor do veículo de acordo com a seguradora onde a seguradora está vendendo para repor parte do dinheiro que ela pagou ao segurado.\nVeículos recuperados de Roubo e Furto onde a seguradora já indenizou o segurado vão para leilão para seguradora repor parte do dinheiro que pagou para o segurado." } } }, "registro_leiloes": { "registros": [ { "lote": "9999", "data_leilao": "04/08/2014", "placa": "AAA9999", "classi": "9AAAA99A1AA999999", "renavam": "", "ano_fabricacao": "2014", "ano_modelo": "", "segmento": "", "sub_segmento": "", "numero_motor": "" } ] }, "registro_sinistros_acidentes": { "possui_registro": "nao" } } }, /* Histórico de Roubo e Furto */ { "historico_roubo_furto": { "registros_roubo_furto": { "possui_registro": "sim", "registros": [ { "boletim_ocorrencia": "4389", "data_boletim_ocorrencia": "28/07/2007", "tipo_ocorrencia": "Declaração de Roubo/Furto", "uf_ocorrencia": "GO" }, { "boletim_ocorrencia": "9812", "data_boletim_ocorrencia": "02/08/2007", "tipo_ocorrencia": "Achado", "uf_ocorrencia": "GO" }, { "boletim_ocorrencia": "95249", "data_boletim_ocorrencia": "13/08/2007", "tipo_ocorrencia": "Devolvido", "uf_ocorrencia": "GO" } ] } } }, /* Verificação junto a Base Estadual (DETRANS) como Renavam e Restrições */ { "informacoes_do_detran": { "numero_renavam": "99999999999", "restricoes_detran": { "situacao_veiculo": "CIRCULACAO", "remarcacao_chassi": "NORMAL", "restricao_furto": { "possui_restricao": "nao", "restricao": "NADA CONSTA", "descricao": "" }, "restricao_guincho": { "possui_restricao": "nao", "restricao": "NADA CONSTA", "descricao": "" }, "restricao_administrativa": { "possui_restricao": "nao", "restricao": "NADA CONSTA", "descricao": "" }, "restricao_judicial": { "possui_restricao": "nao", "restricao": "NADA CONSTA", "descricao": "" }, "restricao_tributaria": { "possui_restricao": "nao", "restricao": "NADA CONSTA", "descricao": "" }, "restricao_judicial_renajud": { "possui_restricao": "nao", "restricao": "NADA CONSTA", "descricao": "" }, "outras_restricoes": { "possui_restricao": "nao", "restricoes": [] }, "comunicacao_venda": { "possui_comunicacao": "nao", "comunicacao": "NADA CONSTA", "descricao": "" } }, "debitos_detran": { "debitos_ipva": { "possui_debido": "sim", "debido": "1.739,10" }, "debitos_multa": { "possui_debido": "sim", "debido": "130,16" }, "debitos_licenciamento": { "possui_debido": "sim", "debido": "239,22" }, "debitos_dpvat": { "possui_debido": "nao", "debido": 0 }, "debitos_municipais": { "possui_debido": "sim", "debido": "130,16" } }, "informacoes_primeiro_faturamento": { "tipo_documento_proprietario": "", "tipo_documento_faturado": "JURIDICA", "documento_faturado": "99999999999999", "estado_faturado": "DF" } } }, /* Verificação junto ao Registro Nacional de Infrações de Trânsito (RENAINF) */ { "registro_debitos_por_infracoes_renainf": { "infracoes_renainf": { "possui_infracoes": "sim", "infracoes": [ { "dados_infracao": { "infracao": "6050 - AVANCAR SINAL VERMELHO DO SEMAFORO OU DE PARADA OBRIGATORIA", "numero_auto_infracao": "R999999999", "valor_aplicado": "293,47", "orgao_autuador": "293730 - GOIANIA", "tipo_auto_infracao": "Eletronico", "local_infracao": "AV 85 X AV T9 QD 61 LOTE 1 3", "municipio": "GOIANIA" }, "aplicacao": { "unidade_medida": "*****", "limite_permitido": "0,00", "medicao_considerada": "0,00", "medicao_real": "0,00" }, "eventos": { "data_hora_infracao": "09/01/2022 05:13", "data_cadastramento": "28/01/2022", "data_notificacao": "28/01/2022", "data_emissao_penalidade": "" } }, { "dados_infracao": { "infracao": "6920 - NAO REGISTRAR VEICULO NO PRAZO DE 30 DIAS", "numero_auto_infracao": "B999999999", "valor_aplicado": "130,16", "orgao_autuador": "109100 - DETRAN", "tipo_auto_infracao": "Manual", "local_infracao": "AV ENG ATILIO CORREA LIMA N", "municipio": "GOIANIA" }, "aplicacao": { "unidade_medida": "*****", "limite_permitido": "0,00", "medicao_considerada": "0,00", "medicao_real": "0,00" }, "eventos": { "data_hora_infracao": "30/12/2021 10:28", "data_cadastramento": "30/12/2021", "data_notificacao": "31/12/2021", "data_emissao_penalidade": "12/03/2022" } } ] } } }, /* Informações sobre a ocorrência de sinistros com Perda Total (PT) */ { "registro_sinistro_com_perda_total": { "possui_registro": "nao", "registro": "" } }, /* Verificação junto a Base Federal (DENATRAN) sobre Restrições Financeiras e Judiciais (RENAJUD) */ { "registro_de_bloqueio_judicial_renajud": { "possui_bloqueio": "nao", "bloqueios": [ { "tribunal": "TRF04", "judiciario": "RSSCR01", "processo": "99999999999999000000001", "tipo_restricao": "Transferencia de Propriedade" }, { "tribunal": "TJRS", "judiciario": "1A VARA CIVEL DE SANTA CRUZ DO SUL", "processo": "99999999999999000000002", "tipo_restricao": "Transferencia de Propriedade" }, { "tribunal": "TJRS", "judiciario": "1A VARA CIVEL DE SANTA CRUZ DO SUL", "processo": "99999999999999000000003", "tipo_restricao": "Transferencia de Propriedade" } ] } }, /* Referência de Preço (Fipe) */ { "referencia_precificador": { "possui_registro": "sim", "decodificador_simplificado": { "origem": "NACIONAL", "local_fabricacao": "SAO BERNARDO DO CAMPO / SP", "pais": "BRASIL", "regiao": "BRASIL / PARAGUAI / COLOMBIA / URUGUAI", "ano_modelo": "2014", "categoria": "UTILITARIO" }, "desvalorizacao": [ { "codigo": "005315-5", "data_ref_fipe": "JAN/2014", "valor": "62413", "valor_zero_km": "48973", "combustivel": "G", "marca": "VW - VolksWagen", "modelo": "Saveiro CROSS 1.6 Mi Total Flex 8V CE", "evolucao": [ { "mes": "JUN/2021", "valor": "48950" }, { "mes": "JUL/2021", "valor": "50466" }, { "mes": "AGO/2021", "valor": "52572" }, { "mes": "SET/2021", "valor": "54201" }, { "mes": "OUT/2021", "valor": "54888" }, { "mes": "NOV/2021", "valor": "55936" }, { "mes": "DEZ/2021", "valor": "57025" }, { "mes": "JAN/2022", "valor": "59264" }, { "mes": "FEV/2022", "valor": "59618" }, { "mes": "MAR/2022", "valor": "59307" }, { "mes": "ABR/2022", "valor": "61182" }, { "mes": "MAI/2022", "valor": "62413" } ] } ], "preco_medio": [ { "versao": "CE CROSS G6 1.6 8V FLEX 101cv 2p Etanol/Gasolina 4x2 Mecânico Picape", "valor": "58200" }, { "versao": "CE CITY G6 1.6 8V FLEX 101cv 2p Etanol/Gasolina 4x2 Mecânico Picape", "valor": "46200" }, { "versao": "CE TROOPER G6 1.6 8V FLEX 101cv 2p Etanol/Gasolina 4x2 Mecânico Picape", "valor": "55000" } ] } }, /* Histórico Recall */ { "possui_recall": "sim", "registros": [ { "data_inicio_campanha": "21/01/2019", "montadora": "VOLKSWAGEN", "sistema_ou_peca": "", "defeito": "", "gravidade": { "indicador": "3", "descricao": "Grande Importancia, Essencial, Emergencial" } } ] }, /* Guia de Imagens */ { "possui_imagens": "sim", "imagens": [ { "descricao": "Veiculo Frente", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p1-830248457.jpg", "observacao": "" }, { "descricao": "Veiculo Traseira", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p2-733311311.jpg", "observacao": "" }, { "descricao": "Morfologia Nr Chassi 1", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p3-192580190.jpg", "observacao": "" }, { "descricao": "Indicacao Nr Chassi 1", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p4-583659017.jpg", "observacao": "Assoalho Direito (a frente do banco do passageiro dianteiro)" }, { "descricao": "Morfologia Nr Motor", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p7-122084130.jpg", "observacao": "" }, { "descricao": "Indicacao Nr Motor", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p8-674204724.jpg", "observacao": "Parte posterior do bloco, entre a juncao do cambio e a do cabecote" }, { "descricao": "Etiquetas destrutiveis", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p9-735276560.jpg", "observacao": "" }, { "descricao": "Morfologia Gravacao Vidros", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p10-188333666.jpg", "observacao": "" }, { "descricao": "Morfologia Nr Cambio", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p14-782304672.jpg", "observacao": "" }, { "descricao": "Indicacao Nr Cambio", "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p15-519236130.jpg", "observacao": "Parte superior do cambio" } ] } ], "request": { "protocolo": "xxxxxxxxxxxx", "tipo_retorno": "JSON" } } ``` # Consultar Saldo Retorna a quantidade de créditos disponíveis em sua conta. `GET` `https://api.consultarplaca.com.br/v2/consultarSaldo` #### Exemplos de respostas 200 - Consulta realizada com sucesso ```json { "status": "ok", "mensagem": "Saldo de créditos obtido com sucesso!", "data_consulta": "2026-01-01 13:30:00", "saldo_creditos": "13.69", "request": [] } ```