BIN V2 - 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/v2/bin/AAA1B11

Secundário:

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

Parâmetros da requisição

Via URL

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

Via Cabeçalho

Authorization: XPTO

Respostas da requisição

200 - Sucesso

{
  "status": "DONE",
  "result": {
    "alerta": {
      "placa": "AAA1B11",
      "retorno": "Veículo cadastrado e com ocorrência de roubo/furto"
    },
    "veiculo": {
      "placa": "AAA1B11",
      "chassi": "INFORMACAO OCULTADA",
      "renavam": "INFORMACAO OCULTADA",
      "situacao": "CIRCULACAO",
      "chassiRemarcado": "N",
      "ultimaAtualizacao": "20/07/2022",
      "municipio": "BELO HORIZONTE",
      "uf": "MG",
      "procedencia": "ESTRANGEIRA",
      "tipo": "AUTOMOVEL",
      "especie": "PASSAGEIRO",
      "tipoMontagem": "COMPLETA",
      "capacidadePassageiros": "005",
      "cor": "BRANCA",
      "potencia": "180",
      "cilindradas": "1798",
      "carroceria": "NAO APLIC.",
      "combustivel": "GASOLINA",
      "motor": "INFORMACAO OCULTADA",
      "caixaCambio": "",
      "restricaoRenainf": "Não",
      "comunicacaoVenda": "Não",
      "pendenciaEmissaoDocumento": "Não",
      "restricaoRenajud": "Não",
      "restricaoRfb": "Não",
      "emplacamentoEletronico": "Não",
      "recall": "Não",
      "dataPreCadastro": "13/02/2015",
      "marcaModelo": "I/AUDI A3 LM 180CV",
      "anoModelo": "2015",
      "anoFabricacao": "2014"
    },
    "proprietario": {
      "tipoDocumento": "CNPJ",
      "numeroDocumento": "INFORMACAO OCULTADA",
      "nome": "INFORMACAO OCULTADA"
    },
    "impedimentos": ["Não tem restrição Informativa ou Impeditiva"],
    "carga": {
      "numeroCarroceria": "",
      "cmt": "3,44",
      "pbt": "1,84",
      "capacidadedeCarga": "0,00",
      "eixos": "02",
      "numeroEixoTraseiro": "",
      "numeroEixoAuxiliar": ""
    },
    "faturamento": {
      "tipoDocumento": "PESSOA JURIDICA",
      "numeroDocumento": "INFORMACAO OCULTADA",
      "uf": "AL"
    },
    "diplomacia": {
      "categoria": "00-",
      "tipoDocumento": "",
      "numDocumento": "",
      "dataAtualizacao": "00/00/0000"
    },
    "restricoes": {
      "comunicacaoVenda": "Não",
      "recall": "Não",
      "renainf": "Não",
      "renajud": "Não",
      "rfb": "Não",
      "rouboFurto": "Veículo com ocorrência de roubo/furto"
    }
  }
}

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/v2/bin/AAA1B11 HTTP/1.1
Host: api.activethread.com.br

cURL

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

JavaScript

const requestOptions = {
  method: "GET",
  redirect: "follow",
};
 
fetch(
  "https://api.activethread.com.br/detran/v2/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/v2/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/v2/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/v2/bin/AAA1B11?at=XPTO")
  .asString();

Python

import requests
 
url = "https://api.activethread.com.br/detran/v2/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

HTTP

GET /detran/v2/bin/AAA1B11 HTTP/1.1
Host: api.activethread.com.br
Authorization: XPTO

cURL

curl --location 'https://api.activethread.com.br/detran/v2/bin/AAA1B11' \
--header 'Authorization: XPTO'

JavaScript

const myHeaders = new Headers();
myHeaders.append("Authorization", "XPTO");
 
const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow",
};
 
fetch("https://api.activethread.com.br/detran/v2/bin/AAA1B11", 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/v2/bin/AAA1B11",
  headers: {
    Authorization: "XPTO",
  },
};
 
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/v2/bin/AAA1B11',
  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',
  CURLOPT_HTTPHEADER => array(
    'Authorization: XPTO'
  ),
));
 
$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/v2/bin/AAA1B11")
  .header("Authorization", "XPTO")
  .asString();

Python

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

BIN V1 BIN V4