BIN V1 - Dados Nacionais

Esta API retorna os dados de um veículo a nível nacional contendo Restrições e o Proprietário Atual.

Montando a requisição

Método da requisição

GET

Endereço da requisição

Principal:

https://api.activethread.com.br/detran/v1/bin/AAA1B11

Secundário:

https://api.detran.app.br/detran/v1/bin/AAA1B11

Parâmetros da requisição

Via URL

https://api.detran.app.br/detran/v1/bin/AAA1B11?at=XPTO

Via Cabeçalho

Authorization: XPTO

Respostas da requisição

200 - Sucesso

Observação: Os dados abaixo são apenas demonstrativos, com a finalidade de mapeamento da estrutura. Por isso, de forma alguma representam a realidade.

{
  "status": "DONE",
  "result": {
    "placa": "AAA1B11",
    "tipo": "0 -",
    "especie": "0 -",
    "capacidadePassageiros": "0",
    "marcaModelo": "VW/SANTANA CG",
    "documentoProprietario": "INFORMACAO OCULTADA",
    "fabricacaoModelo": "1986/0",
    "combustivel": "Alcool",
    "renavam": "INFORMACAO OCULTADA",
    "chassi": "INFORMACAO OCULTADA",
    "cor": "VERMELHA",
    "municipioEmplacamento": "LOBATO",
    "tipoCarroceria": "TESTE",
    "numeroMotor": "",
    "numeroCambio": "",
    "quantidadeEixos": "0",
    "numeroEixoTraseiro": "",
    "numeroEixoAuxiliar": "",
    "numeroCarroceria": "",
    "potencial": "94",
    "cilindradas": "0",
    "capacidadeCarga": "0",
    "pbt": "0",
    "cmt": "0",
    "restricao1": "",
    "restricao2": "",
    "restricao3": "",
    "restricao4": "",
    "ufFaturamento": "PR",
    "documentoFaturamento": "INFORMACAO OCULTADA",
    "dataUltimaAtualizacao": "16/03/2023",
    "tipoMontagem": "COMPLETA",
    "documentoImportador": "",
    "orgaoRFB": "0",
    "numeroREDA": "0",
    "numeroDI": "0",
    "dataRegistroDI": "",
    "dataLimiteRestricaoTributaria": "",
    "dataPreCadastro": "",
    "tipoOperacaoImportacaoVeiculo": "0",
    "numeroProcessoImportacao": "INFORMACAO OCULTADA",
    "dataBaixaTransferenciaOutroPais": "",
    "paisTransferencia": "",
    "restricaoRenainf": "Com multa exigível RENAINF",
    "comunicacaoVenda": "Sem comunicação de venda ativa",
    "indicadorPendenciaEmissao": "Sem pendência de emissão",
    "restricaoRenajud": "Com restrição RENAJUD ativa",
    "ocorrenciaRecall1": "Não há Recall Ativo para o Veículo",
    "ocorrenciaRecall2": "Não há Recall Ativo para o Veículo",
    "ocorrenciaRecall3": "Não há Recall Ativo para o Veículo",
    "restricaoRecall": "Não há Recall Ativo para o Veículo",
    "categoriaMRE": "",
    "documentoProprietarioIndicado": "",
    "dataUltimaAtualizaMRE": "",
    "indicadorEmplacamentoEletronico": "Sem informação de emplacamento eletrônico",
    "restricaoRFB": "Sem registro de restrição RFB",
    "origemIndicacaoPropriedade": "Origem Indicação Propriedade Desconhecido",
    "indicadorPlacaVeicular": "Sem informação de serial ativo",
    "restricoes": {
      "apreensao": "Nao",
      "comunicacaoVenda": "Sem comunicação de venda ativa",
      "informativaImpeditiva": "Não tem restrição Informativa ou Impeditiva",
      "recall": "Não há Recall Ativo para o Veículo",
      "renainf": "Com multa exigível RENAINF",
      "renajud": "Com restrição RENAJUD ativa",
      "rfb": "Sem registro de restrição RFB",
      "rouboFurto": "Sim"
    },
    "situação do veículo": "Veículo cadastrado e com ocorrência de roubo/furto",
    "ufEmplacamento": "PR",
    "situacaoVeiculo": "CIRCULACAO",
    "tipoMarcacaoChassi": "NORMAL",
    "indicadorRemarcacaoChassi": false,
    "marca": "VW",
    "modelo": "SANTANA CG",
    "nacionalidade": "NACIONAL",
    "municipio": "LOBATO",
    "uf": "PR",
    "anoFabricacao": "1986",
    "anoModelo": "0",
    "nomeProprietario": "INFORMACAO OCULTADA",
    "proprietario": {
      "numeroDocumentoProprietario": "INFORMACAO OCULTADA",
      "nomeProprietario": "INFORMACAO OCULTADA",
      "tipoDocumentoProprietario": "CPF"
    },
    "indicadores": {
      "emplacamentoEletronico": "Sem informação de emplacamento eletrônico",
      "placaVeicular": "Sem informação de serial ativo",
      "pendenciaEmissao": "Sem pendência de emissão",
      "remarcacaoChassi": false
    },
    "restricaoRouboFurto": "Sim",
    "restricaoApreensao": "Nao",
    "categoria": "Particular",
    "anoLicenciamento": 0
  }
}

400 - Requisição inválida

Exemplo:

{
  "message": "Por favor, informe uma placa válida."
}

401 - Não autorizado

{
  "message": "Não autorizado."
}

403 - Acesso negado

{
  "message": "Acesso negado!"
}

Exemplos da requisição - Autenticação via URL

HTTP

GET /detran/v1/bin/AAA1B11 HTTP/1.1
Host: api.activethread.com.br

cURL

curl --location 'https://api.activethread.com.br/detran/v1/bin/AAA1B11

JavaScript

const requestOptions = {
  method: "GET",
  redirect: "follow",
};
 
fetch(
  "https://api.activethread.com.br/detran/v1/bin/AAA1B11?at=XPTO",
  requestOptions
)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

NodeJs

const axios = require("axios");
 
let config = {
  method: "get",
  maxBodyLength: Infinity,
  url: "https://api.activethread.com.br/detran/v1/bin/AAA1B11?at=XPTO",
  headers: {},
};
 
axios
  .request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

PHP

<?php
 
$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.activethread.com.br/detran/v1/bin/AAA1B11?at=XPTO',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
));
 
$response = curl_exec($curl);
 
curl_close($curl);
echo $response;

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://api.activethread.com.br/detran/v1/bin/AAA1B11?at=XPTO")
  .asString();

Python

import requests
 
url = "https://api.activethread.com.br/detran/v1/bin/AAA1B11?at=XPTO"
 
payload = {}
headers = {}
 
response = requests.request("GET", url, headers=headers, data=payload)
 
print(response.text)

Exemplos da requisição - Autenticação via Cabeçalho