--- title: "CSV Completa Assíncrona" description: "API Veicular Completa - Dados CSV em Tempo Recorde" lang: pt-BR canonical: https://doc.apibrasil.io/apis/creditos/5943ca1b-9768-4503-9133-caba1ce94995 markdown: https://doc.apibrasil.io/apis/creditos/5943ca1b-9768-4503-9133-caba1ce94995.md source: apibrasil-documentation --- # CSV Completa Assíncrona > API Veicular Completa - Dados CSV em Tempo Recorde - **Categoria:** Consultas Assíncronas - **Cobrança:** por consulta, só com o Bearer Token - **Preço:** R$ 4,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/5943ca1b-9768-4503-9133-caba1ce94995/openapi.json ⚠ Esta API ainda não atende em produção, só em homologação. ## 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 (2 endpoints) ### 1. POST /consulta/veiculos/credits API CSV Completa Assíncrona - Agilidade e Eficiência na Análise de Dados A API CSV Completa Assíncrona permite que você integre rapidamente a extração e análise de dados dos serviços Renainf, Renajud, Bin e Proprietário diretamente no seu sistema, otimizando processos e reduzindo o tempo operacional. Com um simples POST para o endpoint /default, sua empresa recebe retornos completos e estruturados em CSV, prontos para alimentar fluxos internos, auditorias, conciliações e iniciativas de automação. Garanta valor ao seu negócio centralizando informações relevantes em uma única chamada assíncrona, ampliando o potencial de decisão, compliance e customização das suas soluções. - **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": "csv-renainf-renajud-bin-proprietario-async", "placa": "ABC1D23", "webhook_url": "https://webhook.com.br", "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":"csv-renainf-renajud-bin-proprietario-async","placa":"ABC1D23","webhook_url":"https://webhook.com.br","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": "820,150", "balance_before": "820,150", "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": { "accepted": true, "job-id": "a39c209e-db73-44ec-b6bf-af38a350b7fb", "msg": "consulta em processamento; resultado sera enviado ao webhook_url" } } ``` ### 2. POST /consulta/vehicles/credits API CSV Completa Assíncrona - Informações Veiculares em Massa com Agilidade A API CSV Completa Assíncrona permite consultar grandes volumes de informações detalhadas sobre veículos por meio do endpoint exclusivo de créditos, entregando agilidade e praticidade para o seu sistema. Com integração rápida e simples via POST, você obtém respostas estruturadas, facilitando o acompanhamento e análise de dados RENAINF, RENAJUD, BIN e proprietário em lote. Melhore a eficiência operacional do seu negócio, ganhe tempo com automação e amplie suas possibilidades de uso, desde verificações massivas até gestão inteligente de veículos em sua plataforma. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/vehicles/credits` - **Versão da rota:** v2 - **Preço desta operação:** R$ 0,00 por consulta **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "consultar-chave-csv-renainf-renajud-bin-proprietario", "job-id": "a39c209e-db73-44ec-b6bf-af38a350b7fb", "homolog": true } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/vehicles/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"consultar-chave-csv-renainf-renajud-bin-proprietario","job-id":"a39c209e-db73-44ec-b6bf-af38a350b7fb","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": "820,150", "balance_before": "820,150", "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": { "job-id": "a39c209e-db73-44ec-b6bf-af38a350b7fb", "job_status": "completed", "payload": { "consulta": { "CicId": 35, "debitado": true, "id": "00000000-0000-0000-0000-000000000000", "pdf": "/pdf/mockpdf", "valor": 5 }, "dados": { "veicular": { "alerta_indicio": { "descricao_ocorrencia": "NENHUM ALERTA DE INDICIO DE SINISTRO ENCONTRADO NAS BASES CONSULTADAS", "existe_ocorrencia": "0", "status_retorno": { "codigo": "1", "descricao": "CONSULTA CONCLUIDA COM SUCESSO" } }, "bin_nacional": { "alerta_informativo": "", "ano_fabricacao": "2013", "ano_modelo": "2014", "capacidade_carga": "0", "categoria_veiculo": "PARTICULAR", "chassi": "9ZZZZ99Z9Z9999999", "combustivel": "ALCOOL/GASOLINA", "cor_veiculo": "PRETA", "data_emissao_crlv": "06/12/2023", "data_emissao_ultimo_crv": "06/12/2023", "especie_veiculo": "PASSAGEIRO", "logo_fabricante": { "imagem_url": "" }, "marca_modelo": "MARCA/MODELO FICTICIO", "municipio": "CIDADE FICTICIA", "numero_eixos": "2", "off_line": "0", "pbt": "2", "placa": "ABC1D23", "potencia_veiculo": "73", "procedencia": "NACIONAL", "proprietario": { "documento": "00000000000", "nome": "FULANO DE TAL" }, "quantidade_passageiros": "5", "renavam": "00000000000", "restricoes": { "existe_restricao_geral": "0", "existe_restricao_renajud": "0", "existe_restricao_roubo_furto": "0", "mensagens_restricoes": [], "veiculo_baixado": "0" }, "situacao": "EM CIRCULACAO", "status_retorno": { "codigo": "1", "descricao": "CONSULTA CONCLUIDA COM SUCESSO" }, "tipo_carroceria": "NAO APLICAVEL", "tipo_veiculo": "AUTOMOVEL", "uf": "XX" }, "csv": { "mensagem_observacao": "LAUDO CSV CORTESIA COM DADOS FICTICIOS. CONSULTE BASES OFICIAIS PARA INFORMACOES REAIS.", "ocorrencias": [], "quantidade_ocorrencia": "0", "status_retorno": { "codigo": "1", "descricao": "CONSULTA CONCLUIDA COM SUCESSO" } }, "precificador": { "ocorrencias": [ { "ano_modelo": "2014", "codigo": "000000-0", "fabricante_modelo": "MODELO FICTICIO 1.0 FLEX 5P", "informante": "FIPE", "preco": "00000,00", "vigencia": "SETEMBRO DE 2025" } ], "status_retorno": { "codigo": "1", "descricao": "CONSULTA CONCLUIDA COM SUCESSO" } }, "proprietario_atual_veiculo": { "ano_fabricacao": "2013", "ano_modelo": "2014", "chassi": "9ZZZZ99Z9Z9999999", "combustivel": "ALCO/GASOL", "cor_veiculo": "PRETA", "marca_modelo": "MARCA MODELO FICTICIO", "motor": "FAKE1234567890", "municipio": "CIDADE FICTICIA", "placa": "ABC1D23", "proprietario_documento": "000.000.000-00", "proprietario_nome": "FULANO DE TAL", "renavam": "000000000", "status_retorno": { "codigo": "1", "descricao": "CONSULTA CONCLUIDA COM SUCESSO" }, "uf": "XX" }, "recall": { "quantidade_ocorrencias": "0", "status_retorno": { "codigo": "1", "descricao": "CONSULTA CONCLUIDA COM SUCESSO" } }, "renainf": { "ocorrencias": [], "qtd_ocorrencias": "0", "status_retorno": { "codigo": "1", "descricao": "CONSULTA CONCLUIDA COM SUCESSO" } }, "renajud": { "msg_alerta": "", "quantidade_ocorrencias": "0", "status_retorno": { "codigo": "1", "descricao": "CONSULTA CONCLUIDA COM SUCESSO" } } } }, "msg": "CONSULTA CONCLUIDA COM SUCESSO", "success": true } } } ``` 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/5943ca1b-9768-4503-9133-caba1ce94995/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/5943ca1b-9768-4503-9133-caba1ce94995