Estados Unidos — Retiros de Seguridad y Fallas Vehiculares (NHTSA Recalls)

La API de Retiros de Seguridad y Campañas de Reparación Vehicular de EE. UU. de Verifik permite consultar el registro de alertas de seguridad emitidas por la autoridad oficial de seguridad vial en los Estados Unidos.

Permite verificar si un vehículo específico (mediante su número VIN de 17 caracteres) o una línea vehicular general (por Marca, Modelo y Año) se encuentra sujeto a llamados a revisión (safety recalls) abiertos por defectos de fábrica críticos en componentes como bolsas de aire (airbags), sistemas de frenos, dirección, tren motriz o sistemas de software.

---

Casos de Uso

• Gestión de Flotas y Rent-a-Car: Monitoreo preventivo del parque automotor para atender campañas de seguridad antes de arrendar o movilizar vehículos.
• Suscripción de Seguros de Autos: Evaluación del perfil de riesgo mecánico del vehículo al tarificar pólizas de cobertura y responsabilidad civil.
• Marketplaces y Concesionarios de Autos Usados: Garantía de transparencia para compradores verificando que no existan retiros de seguridad críticos pendientes de reparación.

---

Endpoint

GET https://api.verifik.co/v2/usa/vehicle/recalls

Headers

Nombre	Valor	Requerido	Descripción
Accept	application/json	Sí	Formato de respuesta JSON
Authorization	Bearer <token>	Sí	Token JWT de autenticación en Verifik

Parameters

Parámetro	Tipo	Requerido	Descripción
vin	string	Condicional	Número de Identificación Vehicular estandarizado de 17 caracteres (ej. 5YJSA1E26MF123456). Si se suministra, el servicio decodifica automáticamente marca, modelo y año. Requerido si no se envían make, model y modelYear.
make	string	Condicional	Marca fabricante del vehículo (ej. TESLA, FORD, TOYOTA). Requerido si no se envía vin.
model	string	Condicional	Modelo comercial del vehículo (ej. MODEL S, MUSTANG, CAMRY). Requerido si no se envía vin.
modelYear	string	Condicional	Año del modelo del vehículo en formato de 4 dígitos (ej. 2021). Requerido si no se envía vin.

---

Request

Node.js (JavaScript)

import axios from "axios";

const options = {
  method: "GET",
  url: "https://api.verifik.co/v2/usa/vehicle/recalls",
  params: {
    vin: "5YJSA1E26MF123456",
  },
  headers: {
    Accept: "application/json",
    Authorization: "Bearer <tu_token>",
  },
};

try {
  const { data } = await axios.request(options);
  console.log(JSON.stringify(data, null, 2));
} catch (error) {
  console.error("Error al consultar retiros de seguridad del vehículo:", error.response?.data || error.message);
}

Python

import requests

url = "https://api.verifik.co/v2/usa/vehicle/recalls"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <tu_token>"
}
params = {
    "vin": "5YJSA1E26MF123456"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

cURL

curl -X GET "https://api.verifik.co/v2/usa/vehicle/recalls?vin=5YJSA1E26MF123456" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <tu_token>"

---

Response

200 (Con Retiros de Seguridad Abiertos)

{
  "data": {
    "vehicle": {
      "vin": "5YJSA1E26MF123456",
      "make": "TESLA",
      "model": "MODEL S",
      "modelYear": "2021"
    },
    "recallsCount": 1,
    "hasOpenRecalls": true,
    "recalls": [
      {
        "campaignNumber": "21V001000",
        "component": "AIR BAGS",
        "summary": "El módulo del airbag frontal puede experimentar un despliegue involuntario debido a una anomalía en el arnés de cableado.",
        "consequence": "Un despliegue imprevisto del airbag incrementa el riesgo de accidentes o lesiones a los ocupantes.",
        "remedy": "El fabricante reemplazará el conector del arnés de forma gratuita en concesionarios autorizados.",
        "reportDate": "2021-01-15"
      }
    ]
  },
  "signature": {
    "dateTime": "2026-10-31 00:00:00",
    "message": "Certified by Verifik.co"
  }
}

200 (Sin Retiros / Vehículo Seguro)

{
  "data": {
    "vehicle": {
      "vin": "1FA6P8CF5H5123456",
      "make": "FORD",
      "model": "MUSTANG",
      "modelYear": "2022"
    },
    "recallsCount": 0,
    "hasOpenRecalls": false,
    "recalls": []
  },
  "signature": {
    "dateTime": "2026-10-31 00:00:00",
    "message": "Certified by Verifik.co"
  }
}

409 (Faltan Parámetros)

{
  "code": "MissingParameter",
  "message": "Either vin or the combination of make, model, and modelYear must be provided"
}

---

Perfiles de Prueba Sandbox

Consulta	Estatus Esperado	Campañas Reportadas
vin: "5YJSA1E26MF123456"	200 OK	hasOpenRecalls: true, recallsCount: 1
make: "FORD", model: "MUSTANG", modelYear: "2022"	200 OK	hasOpenRecalls: false, recallsCount: 0
Sin parámetros	409 MissingParameter	Error de validación

---

Datos de Prueba (Sandbox Probes)

Utilice los siguientes parámetros de prueba en modo Sandbox para simular cada escenario de respuesta sin consumir créditos de producción:

Escenario	Parámetros a Enviar	Estado HTTP y Resultado Esperado
Vehículo con Recalls (por VIN de 17 caracteres)	vin: "5YJSA1E26MF123456"	200 OK — make: "TESLA", model: "MODEL S", modelYear: "2021", recallsCount: 2, hasRecalls: true
Vehículo con Recalls (por Marca/Modelo/Año)	make: "TESLA", model: "MODEL S", modelYear: "2021"	200 OK — recallsCount: 2, hasRecalls: true, detalle completo de campañas
VIN No Encontrado	vin: "00000000000000000"	404 Not Found — code: "NotFound"
Parámetros Faltantes	Omitir vin y make/model/modelYear	409 Conflict — code: "MissingParameter"