Información de vehículos

Consulta de información vehicular

Endpoint

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

Con una placa brasileña, Verifik devuelve en una sola petición datos estructurados del vehículo para relacionar un activo físico con atributos verificados y normalizados. Está orientada a altas de flota y movilidad, cotización y siniestros de seguros, garantías y crédito con colateral, y revisiones en marketplaces o concesionarios cuando la placa es el identificador principal.

La API de Verifik devuelve un registro normalizado del vehículo para esa placa, con placa, marca, modelo, año modelo y año de fabricación, chasis (VIN), motor, color, tipo de carrocería, combustible, transmisión, puertas, fabricante o planta, códigos FIPE cuando corresponden a ese vehículo, e indicadores de irregularidades o restricciones cuando existen para ese registro. Sirve para comprobar que la unidad coincide con la línea oficial antes de continuar.

Encabezados

Nombre	Valor
Accept	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
plate	string	Sí	Placa a consultar (letras y números; se normaliza el uso de mayúsculas). Ejemplo: PZY7H82.

Solicitud

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 <tu_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 <tu_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 <tu_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 <tu_token>", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: request) { data, _, _ in
  print(String(data: data ?? Data(), encoding: .utf8) ?? "")
}
task.resume()

Respuesta

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 respuesta

Campo	Tipo	Descripción
bodyType	string	Tipo de vehículo devuelto por el registro.
brand	string	Marca del vehículo.
chassis	string	Chasis o VIN devuelto por el registro.
color	string	Color registrado del vehículo.
country	string	País del registro vehicular.
denatranWarning	string	Estado o aviso Denatran cuando está disponible; a menudo una cadena vacía.
doors	string	Capacidad de pasajeros del registro; puede ser "0" cuando la fuente no la provee.
engine	string	Cilindraje o referencia de motor del registro.
factory	string	Origen o región de fabricación.
fipeCodes	string[]	Códigos FIPE relacionados con el vehículo cuando están disponibles.
fuelType	string	Tipo de combustible registrado.
irregularitiesCount	number	Número de restricciones o irregularidades activas encontradas.
irregularityCode	string	Restricciones activas unidas en un texto; vacío cuando no existen restricciones.
manufacturer	string	Fabricante devuelto por el registro.
model	string	Descripción del modelo registrado.
modelYear	string	Año modelo.
plate	string	Placa normalizada devuelta por la consulta.
transmission	string	Transmisión cuando está disponible; los registros obtenidos desde la fuente registral pueden devolver una cadena vacía.
vehicle	string	Categoría vehicular del registro.
version	string	Mejor coincidencia de modelo/versión FIPE cuando está disponible.
yearOfManufacture	string	Año de fabricación.

Notas

• Solo plate es obligatorio en la cadena de consulta.
• Los registros obtenidos desde la fuente registral pueden devolver transmission o denatranWarning como cadena vacía.
• doors puede ser "0" cuando la fuente registral no devuelve capacidad de pasajeros.
• fipeCodes puede ser un arreglo vacío cuando no hay coincidencia FIPE.
• Los proveedores de respaldo pueden devolver una cobertura de campos ligeramente diferente cuando la fuente primaria no encuentra datos.
• Algunas cuentas habilitan una ficha técnica ampliada por placa; usa la URL indicada en tu catálogo de AppFeature cuando corresponda.