Wenmar Open
Decodificador de VIN gratuito, retiros del mercado, boletines de servicio, códigos de falla y tiempos de mano de obra. Sin clave.
Documentación
API
Una API JSON para decodificar VIN y para buscar vehículos por año, marca, modelo, versión y motor. No requiere clave ni cuenta, y cualquier sitio web puede llamarla desde un navegador.
Decodificar un VIN
Se ignoran espacios y guiones. Un dígito de verificación incorrecto no es un error: la respuesta tiene valid establecido en false y una advertencia, porque muchos VIN genuinos de fuera de Norteamérica fallan la verificación. Añade ?year= para usar un año de modelo propio.
curl https://open.wenmarpro.com/v1/vin/KM8K2CAB4PU001140
Decodificar hasta 50 VIN
La respuesta es una lista en el orden solicitado. Cada elemento es una decodificación, o el error que una solicitud individual para ese VIN habría dado.
curl -X POST https://open.wenmarpro.com/v1/vin/batch \
-H 'Content-Type: application/json' \
-d '{"vins": ["KM8K2CAB4PU001140", "1HGCM82633A004352"]}'
Elegir un vehículo paso a paso
Cada paso ofrece solo lo que es válido para los pasos anteriores. Una marca o modelo puede darse por nombre, por un alias como chevy, o por su id. Añade term= para conservar solo los nombres que comiencen con él.
curl https://open.wenmarpro.com/v1/vehicles/years
curl 'https://open.wenmarpro.com/v1/vehicles/makes?year=2019'
curl 'https://open.wenmarpro.com/v1/vehicles/models?make=honda&year=2019'
curl 'https://open.wenmarpro.com/v1/vehicles/submodels?make=honda&model=civic&year=2019'
curl 'https://open.wenmarpro.com/v1/vehicles/engines?make=honda&model=civic&year=2019&submodel=si'
Búsqueda e ids de vehículos
La búsqueda lee lo que la gente escribe. Cada vehículo tiene un id construido a partir de su año y nombres, que permanece igual de una versión de datos a la siguiente mientras los nombres no cambien.
curl 'https://open.wenmarpro.com/v1/vehicles/search?q=2019+civic+si'
curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic_si
Todo para un vehículo
Una respuesta con todo lo que este servidor tiene para un año de modelo, solicitada por id de vehículo o por VIN, con enlaces a sus páginas. Un bloque para el que el servidor no tiene datos es null, por lo que la respuesta tiene los mismos miembros en todos los servidores. Los recalls que contiene son un recuento de las campañas que listan el año, la marca y el modelo, con las tres más recientes; la lista completa tiene su propia dirección. La tercera dirección lista todos los años de modelo de un modelo, los más recientes primero.
curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic/overview
curl https://open.wenmarpro.com/v1/vin/KM8K2CAB4PU001140/overview
curl https://open.wenmarpro.com/v1/models/honda/civic
Recalls
Campañas de recall de NHTSA, para Estados Unidos, y de Transport Canada, las más recientes primero. Una campaña lista un año, una marca y un modelo, por lo que un recall listado aquí puede aplicarse a un vehículo de ese año de modelo. Solo el fabricante puede decir si se aplica a un vehículo concreto: cada respuesta tiene may_apply establecido en true y un objeto de consulta con las consultas oficiales por VIN.
La última dirección lista las campañas reportadas en o después de un día, cada una con los vehículos que lista. Añade country=us o country=ca para un solo país. as_of es el día en que los datos de cada país estaban actualizados, y attribution contiene el crédito que la licencia de los datos exige. Un servidor ejecutado sin datos de recall responde a estas direcciones con 404 y el código dataset_unavailable.
curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic/recalls
curl https://open.wenmarpro.com/v1/vin/KM8K2CAB4PU001140/recalls
curl https://open.wenmarpro.com/v1/recalls/nhtsa/19V888000
curl 'https://open.wenmarpro.com/v1/recalls?make=honda&year=2019'
curl 'https://open.wenmarpro.com/v1/recalls/recent?since=2026-01-01'
Calificaciones de pruebas de choque
Las calificaciones de pruebas de choque de NHTSA para un año de modelo, de su Programa de Evaluación de Autos Nuevos. NHTSA califica un vehículo por estilo de carrocería y tracción, por lo que la respuesta a menudo tiene varias calificaciones y sus estrellas pueden diferir: cada una dice para qué vehículo es, en palabras de NHTSA, y ninguna se elige por ti. Una calificación sin estrellas es un vehículo que NHTSA lista y no ha probado.
as_of es el día en que el archivo de NHTSA estaba actualizado. La misma respuesta es el miembro safety de la vista general de un vehículo. Un servidor ejecutado sin las calificaciones responde a esta dirección con 404 y el código dataset_unavailable.
curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic/safety
Combustible, especificaciones, fluidos y neumáticos
Lo que se tiene sobre un año de modelo además de sus recalls: calificaciones de consumo de combustible de EPA y Recursos Naturales de Canadá, especificaciones de los archivos de EPA, el grado de aceite de motor que EPA registra con los fluidos que una persona leyó de los documentos del propio fabricante, y los ajustes de neumáticos de equipo original. Cada uno tiene una dirección para un id de vehículo y una para un VIN, como /v1/vin/{vin}/fuel.
Una cifra nunca se da con más precisión de la que se emparejó: confidence dice modelo, motor o submodelo, y un motor se nombra solo donde el emparejamiento lo resolvió. Por VIN, combustible, especificaciones y fluidos contienen solo lo que es para el motor decodificado cuando la decodificación lo resuelve, y engine_settled lo dice. Los ajustes de neumáticos nunca se reducen. Un registro leído a mano lleva su fuente y el día en que se verificó, y una lista vacía significa que nadie lo ha registrado: nada se estima.
Este servidor tiene: /v1/vehicles/{id}/fuel, /v1/vehicles/{id}/specs, /v1/vehicles/{id}/fluids. Una dirección que no tiene responde 404 con el código dataset_unavailable.
curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic/fuel
Lo que reportan los propietarios
Lo que los propietarios reportaron a NHTSA sobre un año de modelo, como recuentos por componente con el kilometraje mediano que dieron: estos son reportes de propietarios, no verificados, y un recuento no es una tasa. Un servidor ejecutado sin las quejas responde a esta dirección con 404 y el código dataset_unavailable.
curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic/complaints
Errores
Un error es un objeto JSON con un miembro, error, que tiene un código, un mensaje y detalles. El estado HTTP es la señal principal.
400 invalid_vin: longitud incorrecta o caracteres ilegales; details.suggestions lista correcciones probables. 400 validation_failed: falta un parámetro o cuerpo, o es incorrecto. 404 not_found: no hay fabricante registrado para los primeros tres caracteres del VIN, o ningún vehículo tiene ese id. 429 rate_limited: demasiadas solicitudes. 500 internal_error: culpa nuestra.
Límites
Una dirección puede hacer 600 solicitudes por minuto. Eso es mucho más de lo que una tienda necesita, y existe solo para que un cliente no pueda ralentizar el servicio para todos. Por encima de eso, la respuesta es 429 con un encabezado Retry-After que dice cuántos segundos esperar.
Un lote contiene como máximo 50 VIN. Un cuerpo de solicitud puede tener como máximo 16 KB.
Caché y versiones
Cada respuesta lleva la versión de datos en un encabezado X-Data-Version. Las respuestas no cambian hasta que los datos cambian, por lo que los GET exitosos pueden almacenarse en caché durante un día y llevan un ETag; envíalo de vuelta en If-None-Match para obtener un 304.
Los campos y endpoints solo se añaden. Nada que se haya publicado se elimina ni se le da un nuevo significado.
Para agentes de IA
Un asistente que pueda obtener una dirección web puede decodificar un VIN con una solicitud. No hay clave que pedir ni nada a lo que registrarse.
La respuesta es JSON: el año, la marca, el modelo, la versión, el motor y el equipo de seguridad, y una lista de advertencias. Un dígito de verificación incorrecto es una advertencia, no un error.
curl https://open.wenmarpro.com/v1/vin/KM8K2CAB4PU001140
Servidor MCP
Las mismas consultas son herramientas en un servidor de Protocolo de Contexto de Modelo: wenmar_vin, wenmar_vehicles, wenmar_recalls y wenmar_bulletins. Un recall que wenmar_recalls lista puede aplicarse a un vehículo de ese año, marca y modelo; solo el fabricante puede confirmarlo para un VIN. Un boletín que wenmar_bulletins lista es para un año de modelo y no es un recall. El servidor habla HTTP Streamable y no necesita clave. Añade esta dirección como servidor remoto o conector personalizado:
https://open.wenmarpro.com/mcp