--- title: "Veículos Total" description: "API Veículos Total - Consulta de veículos em segundos pelo número da placa" lang: pt-BR canonical: https://doc.apibrasil.io/apis/creditos/8a762903-6f27-4ea2-8b63-9f95f756c34f markdown: https://doc.apibrasil.io/apis/creditos/8a762903-6f27-4ea2-8b63-9f95f756c34f.md source: apibrasil-documentation --- # Veículos Total > API Veículos Total - Consulta de veículos em segundos pelo número da placa - **Categoria:** Precificação Veicular - **Cobrança:** por consulta, só com o Bearer Token - **Preço:** R$ 30,00 por consulta - **Limite:** 999.000 por mês - **Cadastro:** exige CNPJ - **Versão:** v2 - **Publicada por:** APIBrasil - **Especificação OpenAPI:** https://doc.apibrasil.io/apis/creditos/8a762903-6f27-4ea2-8b63-9f95f756c34f/openapi.json ## Como chamar **Endereço base:** `https://gateway.apibrasil.io/api/v2` Autenticação: cabeçalho `Authorization: Bearer `. Nada além disso. Com `homolog: true` no corpo, o gateway responde de uma base fixa, com a forma real da resposta, e não cobra. O CPF 00000000000 é dessa base e não é de ninguém: use-o nos testes, nunca em produção. ## Endpoints (1 endpoint) ### 1. POST /consulta/veiculos/credits API Veículos Total - Consulta Completa de Veículos por Placa em Instantes Com a API Veículos Total, seu sistema ganha acesso instantâneo a informações detalhadas de veículos a partir da placa informada, proporcionando agilidade e precisão nas suas operações. Ideal para empresas de seguros, concessionárias, financeiras e marketplaces automotivos, a integração via POST no endpoint consulta/veiculos/credits é rápida e descomplicada, acelerando a implantação e o retorno sobre o investimento. Obtenha dados completos e atualizados diretamente em sua plataforma, potencializando decisões estratégicas, automatização de processos e melhor experiência para o seu usuário. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/veiculos/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "veiculos-total", "placa": "ABC1234", "homolog": true } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/veiculos/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"veiculos-total","placa":"ABC1234","homolog":true}' ``` Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação. **Resposta de exemplo, do catálogo** ```json { "user": { "first_name": "[omitido]", "email": "[omitido]", "cellphone": "[omitido]", "notification": "yes" }, "balance": "105,660", "balance_before": "105,660", "tax": "0,000", "status_code": 200, "error": false, "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.", "valor_consulta": 0, "api_limit_for": "homolog", "homolog": true, "data": { "acessorios": { "veiculosFipe": [] }, "acessoriosCategorizados": { "acessorios": [], "categorias": [] }, "analiseRisco": { "imageLink": null, "indiceRisco": "2", "parecer": "Veiculo sem indicio real, dados ficticios para homologacao" }, "anoFabricacao": "2021", "anoModelo": "2022", "anuncio": { "data": "03/05/2024 14:22:11", "fotos": [], "km": "12850", "observacao": "Oferta teste exclusiva para ambiente de desenvolvimento.", "opcionais": [ { "descricao": "Direcao eletrica" }, { "descricao": "Camera de reverso" }, { "descricao": "Chave presencial" } ], "placa": "ABC9234", "valor": "125000.00" }, "baseEstadual": { "categoria": "PARTICULAR", "chassi": "8AJZZZ999JZ123456", "combustivel": "GASOLINA/EL", "comunicacaoInclusao": null, "comunicacaoVenda": "NAO CONSTA COMUNICACAO DE VENDAS", "cor": "AZUL", "dataAlteracaoMotor": null, "dataEmissaoCrv": "10/01/2024", "dataInclusaoIntencaoTrocaFinanceira": null, "dataLimiteRestricaoTributaria": null, "dataVenda": null, "dataVigenciaContratoFinanceira": null, "debitoCetesb": null, "debitoDer": null, "debitoDersa": null, "debitoDetran": null, "debitoDpvat": null, "debitoIpva": "0,00", "debitoLicenciamento": "0,00", "debitoMultas": "0,00", "debitoMunicipais": "0,00", "debitoPoliciaRodoviariaFederal": null, "debitoRenainf": null, "especie": "PASSAGEIRO", "exercicioLicenciamento": null, "existeDebitoDpvat": "NAO EXISTE DEBITO DE DPVAT", "existeDebitoIpva": "NAO EXISTE DEBITO DE IPVA", "existeDebitoLicenciamento": "NAO EXISTE DEBITO DE LICENCIAMENTO", "existeDebitoMulta": "NAO EXISTE DEBITO DE MULTA", "licdata": "10/01/2024", "motor": "XZ9JK123456", "municipio": "CIDADE INVENTADA", "observacoes": null, "outrasRestricoes1": "NADA CONSTA", "outrasRestricoes2": "NADA CONSTA", "outrasRestricoes3": "NADA CONSTA", "outrasRestricoes4": "NADA CONSTA", "placa": "ABC1234", "pronome": "EMPRESA FICTICIA LTDA", "pronomeAnterior": null, "renavam": "00999111222", "restricaoAdminisrativa": "NADA CONSTA", "restricaoAmbiental": null, "restricaoArrendatario": null, "restricaoDataInclusao": null, "restricaoDocArrendatario": null, "restricaoFinanceira": "NADA CONSTA", "restricaoGuincho": "NADA CONSTA", "restricaoJudicial": "NADA CONSTA", "restricaoNomeAgente": null, "restricaoRenajud": "NADA CONSTA", "restricaoRouboFurto": "NADA CONSTA", "restricaoTributaria": "NADA CONSTA", "situacaoVeiculo": "CIRCULACAO", "tipo": "AUTOMOVEL", "tipoMarcacaoChassi": "NORMAL", "uf": "SP" }, "baseNacional": { "anoFabricacao": "2021", "anoModelo": "2022", "categoria": "PARTICULAR", "chassi": "8AJZZZ999JZ123456", "combustivel": "GASOLINA/EL", "cor": "AZUL", "di": null, "docFaturado": "12345000000123", "dtEmissaoCrv": null, "dtUltimaAtualizacao": null, "especie": "PASSAGEIRO", "especieVeiculo": "PASSAGEIRO", "indicadorComunicacaoVendas": "NAO", "indicadorRestricaoRenajud": "NAO", "motor": "XZ9JK123456", "municipio": "CIDADE INVENTADA", "ocorrencia": "VEICULO NAO INDICA OCORRENCIA DE ROUBO/FURTO", "outrasRestricoes1": "NADA CONSTA", "outrasRestricoes2": "NADA CONSTA", "outrasRestricoes3": "NADA CONSTA", "outrasRestricoes4": "NADA CONSTA", "outrasRestricoes5": "NADA CONSTA", "outrasRestricoes6": "NADA CONSTA", "outrasRestricoes7": "NADA CONSTA", "outrasRestricoes8": "NADA CONSTA", "placa": "ABC1234", "renavam": "00999111222", "restricao1": "NADA CONSTA", "restricao2": "NADA CONSTA", "restricao3": "NADA CONSTA", "restricao4": "NADA CONSTA", "restricaoDataInclusao": null, "restricaoFinanciadora": "NADA CONSTA", "restricaoFinanciamento": null, "restricaoNomeAgente": null, "restricaoTipoTransacao": "NADA CONSTA", "situacaoVeiculo": "CIRCULACAO", "tipoDocFaturado": "JURIDICA", "tipoDocImportadora": null, "tipoMarcacaoChassi": "NORMAL", "tipoVeiculo": "AUTOMOVEL", "uf": "SP", "ufFaturado": null }, "caixaCambio": null, "capMaxTracao": "0,0000", "capacidadeCarga": "00000", "capacidadePassageiro": "5", "categoria": "BU - SUV MEDIO", "cestaBasica": { "registros": [], "veiculosFipe": [] }, "chassi": "8AJZZZ999JZ123456", "cidade": "NAO IDENTIFICADO", "cilindradas": "1999", "cmt": null, "codigoCombustivel": "GASOLINA/EL", "codigoFipe": [ { "codigo": "002999-9", "valorZeroKM": null }, { "codigo": "002998-1", "valorZeroKM": null } ], "codigoMarcaModelo": "909090", "combustivel": "GASOLINA/EL", "comparativoEspecificacoes": { "opinioesDoDono": [], "veiculoComparativo": [] }, "corVeiculo": "AZUL", "custoMedio": { "custoCada10k": [], "custoDesgastePecasTotal": 0, "custoPlanoRevisaoTotal": 0, "custoTotal": 0 }, "dadosBasicosDoVeiculo": { "anoFabricacao": "2021", "anoModelo": "2022", "chassi": "8AJZZZ999JZ123456", "cilindradas": "1999", "codigoFipe": "002999", "combustivel": "Gasolina, Eletrico", "descricao": "SUV CONCEITO FLEX", "informacoesFipe": [ { "ano": "2022", "combustivel": "Hibrido", "fipeId": "002999", "historicoPreco": [ { "ano": "2023", "mes": "1", "predicao": false, "valor": "150000" }, { "ano": "2023", "mes": "7", "predicao": false, "valor": "152500" }, { "ano": "2024", "mes": "1", "predicao": false, "valor": "154000" }, { "ano": "2024", "mes": "6", "predicao": false, "valor": "155500" }, { "ano": "2025", "mes": "1", "predicao": false, "valor": "158900" } ], "marca": "Marca Ficticia", "modelo": "Modelo Demo", "valorAtual": "158900.00", "versao": "Pack Tecnologia 2.0 Hibrido" } ], "informacoesGerais": [ { "fipeId": "002999", "idVersao": "5555", "marca": "Marca Ficticia", "modelo": "SUV Demo", "versao": "Pack Tecnologia 2.0" } ], "marca": "MARCA FICTICIA", "nacional": "NACIONAL", "placa": "ABC1234" }, "decodificadorPrecificador": { "anoFabricacao": null, "anoModelo": "2022", "categoria": "AUTOMOVEL", "chassi": "8AJZZZ999JZ123456", "classificacao": null, "codigoFipe": null, "combustivel": null, "comprimento": null, "cor": null, "distanciaEntreEixos": null, "localFabricacao": "FABRICA TESTE / SP", "marca": "MARCA FICTICIA", "modelo": "SUV CONCEITO", "motor": null, "origem": "NACIONAL", "pais": "BRASIL", "pesoBruto": null, "portas": null, "potenciaMotor": "2.0", "precificadorI": [ { "codigo": "002999-9", "combustivel": "H", "dataRefFipe": null, "graphMes1": null, "graphMes10": null, "graphMes11": null, "graphMes12": null, "graphMes2": null, "graphMes3": null, "graphMes4": null, "graphMes5": null, "graphMes6": null, "graphMes7": null, "graphMes8": null, "graphMes9": null, "graphValor1": null, "graphValor10": null, "graphValor11": null, "graphValor12": null, "graphValor2": null, "graphValor3": null, "graphValor4": null, "graphValor5": null, "graphValor6": null, "graphValor7": null, "graphValor8": null, "graphValor9": null, "marca": "Marca Ficticia", "modelo": "SUV Conceito 2.0 Hibrido", "valor": "168200", "valorZeroKM": null }, { "codigo": "002998-1", "combustivel": "F", "dataRefFipe": null, "graphMes1": null, "graphMes10": null, "graphMes11": null, "graphMes12": null, "graphMes2": null, "graphMes3": null, "graphMes4": null, "graphMes5": null, "graphMes6": null, "graphMes7": null, "graphMes8": null, "graphMes9": null, "graphValor1": null, "graphValor10": null, "graphValor11": null, "graphValor12": null, "graphValor2": null, "graphValor3": null, "graphValor4": null, "graphValor5": null, "graphValor6": null, "graphValor7": null, "graphValor8": null, "graphValor9": null, "marca": "Marca Ficticia", "modelo": "SUV Conceito 2.0 Flex", "valor": "161500", "valorZeroKM": null } ], "precificadorII": [ { "combustivel": null, "marca": "Marca Ficticia", "modelo": "SUV CONCEITO", "valor": "175000", "versao": "2.0 HIBRIDO 4p Mec" }, { "combustivel": null, "marca": "Marca Ficticia", "modelo": "SUV CONCEITO", "valor": "177500", "versao": "2.0 HIBRIDO 4p Aut" }, { "combustivel": null, "marca": "Marca Ficticia", "modelo": "SUV CONCEITO", "valor": "180000", "versao": "2.0 PREMIUM 4p Aut" } ], "quantidadeEixos": null, "quantidadeIrregularidades": null, "regiao": "BRASIL / TESTE", "tipoCarroceria": "SUV", "tipoFreio": null, "tipoMotor": null, "tracao": null, "transmissao": null, "versao": "HIBRIDO" }, "docFaturado": "12345000000123", "dtUltimaAtualizacao": null, "eixoTraseiroDif": null, "eixos": "2", "especieVeiculo": "PASSAGEIRO", "fichaTecnica": { "registros": [], "veiculosFipe": [] }, "fotos": [], "fotosLoteVeiculo": { "conteudo": [] }, "gravame": [ { "agente": "BANCO FICTICIO S/A", "anoFabricacao": null, "anoModelo": null, "chassi": "8AJZZZ999JZ123456", "codigoAgente": null, "contrato": "SIRCAF: SIM 0", "dataEmissao": null, "dataInclusao": null, "dataSituacao": null, "dataVigencia": null, "dataVigenciaContrato": null, "documentoAgente": null, "documentoFinanciado": "10020030040", "gravame": "VEICULO TEVE GRAVAME BAIXADO PELO AGENTE FINANCEIRO", "intencao": null, "municipio": null, "numero": "80020010", "observacoes": "Historico", "placa": "ABC1234", "renavam": "00999111222", "responsavel": "FINANCEIRA", "situacao": "VEICULO TEVE GRAVAME BAIXADO PELO AGENTE FINANCEIRO", "uf": null, "ufPlaca": null }, { "agente": "COOPERATIVA DEMO CREDITO", "anoFabricacao": null, "anoModelo": null, "chassi": "8AJZZZ999JZ123456", "codigoAgente": null, "contrato": "SIRCAF: SIM 0", "dataEmissao": null, "dataInclusao": null, "dataSituacao": null, "dataVigencia": null, "dataVigenciaContrato": null, "documentoAgente": null, "documentoFinanciado": "50060070080", "gravame": "VEICULO TEVE GRAVAME BAIXADO PELO AGENTE FINANCEIRO", "intencao": null, "municipio": null, "numero": "80020011", "observacoes": "Historico", "placa": "ABC1234", "renavam": "00999111222", "responsavel": "FINANCEIRA", "situacao": "VEICULO TEVE GRAVAME BAIXADO PELO AGENTE FINANCEIRO", "uf": null, "ufPlaca": null }, { "agente": "FINTECH PILOTO LTDA", "anoFabricacao": null, "anoModelo": null, "chassi": "8AJZZZ999JZ123456", "codigoAgente": null, "contrato": "SIRCAF: SIM 0", "dataEmissao": null, "dataInclusao": null, "dataSituacao": null, "dataVigencia": null, "dataVigenciaContrato": "31/12/2025", "documentoAgente": null, "documentoFinanciado": "70080090010", "gravame": "VEICULO COM ALIENACAO FIDUCIARIA PENDENTE EMISSAO DE DOCUMENTO", "intencao": null, "municipio": null, "numero": "80020012", "observacoes": "Atual", "placa": "ABC9234", "renavam": "00999111222", "responsavel": "FINANCEIRA", "situacao": "VEICULO COM ALIENACAO FIDUCIARIA PENDENTE EMISSAO DE DOCUMENTO", "uf": null, "ufPlaca": null } ], "historicoAnuncios": [ { "data": "03/05/2024 14:22:11", "fotos": [], "km": "12850", "observacao": "Oferta teste exclusiva para ambiente de desenvolvimento.", "opcionais": [ { "descricao": "Direcao eletrica" }, { "descricao": "Camera de reverso" }, { "descricao": "Chave presencial" } ], "placa": "ABC9234", "valor": "125000.00" } ], "historicoKm": [ { "dataInclusao": "03/05/2024 14:22:11", "km": "12850" } ], "historicoProprietarios": [ { "anoExercicio": "2024", "chassi": "8AJZZZ999JZ123456", "correlacaoChassiRenavam": false, "cpfCnpj": "10020030040", "dataEmplacamento": null, "dataProcessamento": null, "motivoTipoAutorizacao": null, "municipio": null, "ocorrencia": null, "placa": "ABC1234", "proprietario": "EMPRESA FICTICIA LTDA", "renavam": "00999111222", "tipoDocumento": null, "uf": "SP" }, { "anoExercicio": "2023", "chassi": "8AJZZZ999JZ123456", "correlacaoChassiRenavam": false, "cpfCnpj": "50060070080", "dataEmplacamento": null, "dataProcessamento": null, "motivoTipoAutorizacao": null, "municipio": null, "ocorrencia": null, "placa": "ABC9234", "proprietario": "LOCADORA DEMO SA", "renavam": "00999111222", "tipoDocumento": null, "uf": "SP" }, { "anoExercicio": "2022", "chassi": "8AJZZZ999JZ123456", "correlacaoChassiRenavam": false, "cpfCnpj": "70080090010", "dataEmplacamento": null, "dataProcessamento": null, "motivoTipoAutorizacao": null, "municipio": null, "ocorrencia": null, "placa": "ABC1234", "proprietario": "PESSOA FISICA TREINAMENTO", "renavam": "00999111222", "tipoDocumento": null, "uf": "SP" } ], "identImportadora": null, "indicioSinistro": { "classificacao": null, "descricao": "NAO CONSTA INDICIO DE SINISTRO PARA O VEICULO INFORMADO" }, "leilao": { "descricao": "Nao consta registro de leilao para o veiculo informado", "registros": [], "score": { "aceitacao": null, "exigenciaVistoriaEspecial": null, "percentualSobreRef": null, "pontuacao": null, "score": null } }, "limiteRestricaoTrib": null, "marcaModelo": "MARCA FICTICIA/SUV CONCEITO", "municipio": "NAO IDENTIFICADO", "municipioEmplacamento": "NAO IDENTIFICADO", "nacionalidade": "NACIONAL", "numCarroceria": "INEXISTENTE", "numFaturado": "12345000000123", "numMotor": "XZ9JK123456", "numTerceiroEixo": null, "opcionais": [], "pbt": "0,0180", "placa": "ABC1234", "potencia": "180", "procedencia": "NACIONAL", "qtdPax": "5", "recall": { "anoModelo": null, "chassi": null, "descricaoRetorno": null, "detalhes": [], "marca": null, "modelo": null, "recallsPendente": [] }, "registroDi": null, "registroEmLocadora": { "registroEmLocadora": false }, "renavam": "00999111222", "restricoes": null, "revisao": { "veiculosFipe": [] }, "rouboFurto": { "constaOcorrencia": false, "constaOcorrenciaAtiva": false, "historico": [], "indicadorProcedencia": null, "municipioEmplacamento": null }, "situacaoChassi": " ", "situacaoVeiculo": " ", "tipoCarroceria": "Desconhecido", "tipoDocFaturado": "JURIDICA", "tipoDocImportadora": "DESCONHECIDA", "tipoMontagem": "1", "tipoVeiculo": "AUTOMOVEL", "uf": "--", "ufFaturado": "SP", "ultimaDataInclusao": null, "valorAnunciado": null } } ``` Nos exemplos de resposta, os campos da conta que gerou o exemplo (`user.first_name`, `user.email`, `user.cellphone`) saem como `[omitido]`. O resto é o que o catálogo publica. ## Armadilhas: o que uma integração erra sem avisar Apuradas nas respostas que o próprio catálogo publica. Em todas elas o código funciona no caminho feliz e falha em silêncio no resto: 1. **O erro chega no CORPO, com HTTP 200.** A resposta traz um campo `error` booleano e uma `message`. Checar só `response.ok` ou o status HTTP deixa passar falha como sucesso. Confira SEMPRE `error === false` antes de ler `data`. 2. **`balance`, `tax` e `extra_charges.total` são STRING em formato brasileiro — e o formato varia entre APIs.** Valores observados no catálogo: `"154,380"`, `"497,84"`, `"0,000"` e `"0.19"`. Vírgula em umas, ponto em outra; três casas decimais em umas, duas em outra. Em JavaScript, `parseFloat("154,380")` devolve `154` e perde os centavos sem erro nenhum, e `Number("154,380")` devolve `NaN`. Escreva um conversor que trate os dois separadores, e nunca use esses campos numa decisão financeira sem convertê-los. 3. **Cada chamada custa dinheiro.** Retry cego multiplica a conta. Nunca repita automaticamente um 4xx: parâmetro errado repetido continua errado e continua cobrando. Repita só tempo esgotado e 5xx, com recuo exponencial e um teto pequeno de tentativas. 4. **HTTP 402 é saldo insuficiente, e repetir não resolve.** É o único status que exige ação humana — recarregar. Trate-o como erro terminal, com mensagem própria, e não o jogue no mesmo balde dos 4xx genéricos. 5. **`extra_charges` cobra à parte do preço da consulta.** Quando o corpo pede serviços adicionais, a resposta traz cada um com o preço e um `total` que NÃO está incluso no valor base. Se você mostra custo a quem usa, some os dois. ## Ver também - Especificação OpenAPI: https://doc.apibrasil.io/apis/creditos/8a762903-6f27-4ea2-8b63-9f95f756c34f/openapi.json - Catálogo de APIs: [Catálogo de APIs](https://doc.apibrasil.io/apis.md) - SDKs oficiais: [SDKs oficiais](https://doc.apibrasil.io/sdks.md) - Índice da documentação: https://doc.apibrasil.io/llms.txt - Versão HTML desta página: https://doc.apibrasil.io/apis/creditos/8a762903-6f27-4ea2-8b63-9f95f756c34f