🇧🇷 Brasil — Informações do veículo

Consulta de informações do veículo

Endpoint

GET https://api.verifik.co/v2/br/vehicle

Com uma placa brasileira, a Verifik devolve em uma única requisição dados estruturados do veículo para vincular um ativo físico a atributos verificados e normalizados. É voltada a onboarding de frota e mobilidade, cotação e sinistros de seguro, financiamento garantido e análise de colateral, e checagens em marketplace ou concessionária quando a placa é o identificador principal.

A API Verifik devolve um registro normalizado do veículo para essa placa, incluindo placa, marca, modelo, ano modelo e ano de fabricação, chassi (VIN), motor, cor, tipo de carroceria, combustível, transmissão, portas, fabricante ou planta, códigos FIPE quando se aplicam ao veículo, e indicadores de irregularidades ou restrições quando existem para aquele cadastro. Use para confirmar se a unidade corresponce à linha oficial antes de seguir.

Cabeçalhos

Nome	Valor
Accept	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição
plate	string	Sim	Placa a consultar (letras e números; a capitalização é normalizada). Exemplo: PZY7H82.

Requisição

JavaScript

import axios from "axios";

const options = {
  method: "GET",
  url: "https://api.verifik.co/v2/br/vehicle",
  params: { plate: "PZY7H82" },
  headers: {
    Accept: "application/json",
    Authorization: "Bearer <your_token>",
  },
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <your_token>",
}
conn.request("GET", "/v2/br/vehicle?plate=PZY7H82", "", headers)
res = conn.getresponse()
print(res.read().decode("utf-8"))

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.verifik.co/v2/br/vehicle', [
  'query' => ['plate' => 'PZY7H82'],
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'Bearer <your_token>',
  ],
]);
echo $response->getBody();

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/br/vehicle?plate=PZY7H82")!)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("Bearer <your_token>", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: request) { data, _, _ in
  print(String(data: data ?? Data(), encoding: .utf8) ?? "")
}
task.resume()

Resposta

200

{
  "data": {
    "bodyType": "AU - HATCH PEQUENO",
    "brand": "HYUNDAI",
    "chassis": "9BHBG51CAJP791679",
    "color": "BRANCA",
    "country": "Brasil",
    "denatranWarning": "",
    "doors": "0",
    "engine": "998",
    "factory": "NACIONAL",
    "fipeCodes": [],
    "fuelType": "ALCOOL / GASOLINA",
    "irregularitiesCount": 0,
    "irregularityCode": "",
    "manufacturer": "HYUNDAI",
    "model": "HYUNDAI/HB20 1.0M COMFOR",
    "modelYear": "2018",
    "plate": "PZY7H82",
    "transmission": "",
    "vehicle": "AUTOMOVEL",
    "version": "HB20",
    "yearOfManufacture": "2017"
  },
  "signature": {
    "dateTime": "June 30, 2026 3:10 PM",
    "message": "Certified by Verifik.co"
  }
}

404

{
  "code": "NotFound",
  "message": "Record not found."
}

409

{
  "code": "MissingParameter",
  "message": "missing plate\n"
}

500

{
  "code": "InternalServerError",
  "message": "Server error."
}

Campos de resposta

Campo	Tipo	Descrição
bodyType	string	Tipo de veículo retornado pelo registro.
brand	string	Marca do veículo.
chassis	string	Chassi ou VIN retornado pelo registro.
color	string	Cor registrada do veículo.
country	string	País do registro do veículo.
denatranWarning	string	Status ou aviso do Denatran quando disponível; muitas vezes uma string vazia.
doors	string	Capacidade de passageiros do registro; pode ser "0" quando a fonte não a informa.
engine	string	Cilindrada ou referência de motor no registro.
factory	string	Origem ou região de fabricação.
fipeCodes	string[]	Códigos FIPE relacionados ao veículo quando disponíveis.
fuelType	string	Tipo de combustível registrado.
irregularitiesCount	number	Número de restrições ou irregularidades ativas encontradas.
irregularityCode	string	Restrições ativas unidas em uma string; vazio quando não há restrições.
manufacturer	string	Fabricante retornado pelo registro.
model	string	Descrição do modelo registrado.
modelYear	string	Ano do modelo.
plate	string	Placa normalizada retornada pela consulta.
transmission	string	Transmissão quando disponível; registros obtidos pela fonte registral podem retornar uma string vazia.
vehicle	string	Categoria do veículo no registro.
version	string	Melhor correspondência de modelo/versão FIPE quando disponível.
yearOfManufacture	string	Ano de fabricação.

Notas

• Apenas plate é obrigatório na query string.
• Registros obtidos pela fonte registral podem retornar transmission ou denatranWarning como string vazia.
• doors pode ser "0" quando a fonte registral não retorna capacidade de passageiros.
• fipeCodes pode ser um array vazio quando não houver correspondência FIPE.
• Provedores de fallback podem retornar cobertura de campos ligeiramente diferente quando a fonte primária não encontrar dados.
• Algumas contas também habilitam o produto ficha técnica estendida por placa; use a URL do seu catálogo AppFeature quando esse recurso estiver ativo.