Wenmar Open

Decodificador de VIN gratuito, recalls, boletins de serviço, códigos de falha e tempos de mão de obra. Sem chave.

Ver em wenmarpro.com

Documentação

API

Uma API JSON para decodificação de VIN e para consulta de veículos por ano, marca, modelo, versão e motor. Não requer chave nem conta, e qualquer site pode chamá-la a partir de um navegador.

Decodificar um VIN

Espaços e hífens são ignorados. Um dígito verificador incorreto não é um erro: a resposta tem valid definido como false e um aviso, porque muitos VINs genuínos de fora da América do Norte falham na verificação. Adicione ?year= para usar um ano-modelo de sua escolha.

curl https://open.wenmarpro.com/v1/vin/KM8K2CAB4PU001140

Decodificar até 50 VINs

A resposta é uma lista na ordem solicitada. Cada item é uma decodificação, ou o erro que uma solicitação única para aquele VIN teria retornado.

curl -X POST https://open.wenmarpro.com/v1/vin/batch \
  -H 'Content-Type: application/json' \
  -d '{"vins": ["KM8K2CAB4PU001140", "1HGCM82633A004352"]}'

Escolher um veículo passo a passo

Cada passo oferece apenas o que é válido para os passos anteriores. Uma marca ou modelo pode ser informada pelo nome, por um alias como chevy, ou pelo seu id. Adicione term= para manter apenas nomes que começam com ele.

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'

Pesquisa e ids de veículos

A pesquisa lê o que as pessoas digitam. Todo veículo tem um id construído a partir do seu ano e nomes, que permanece o mesmo de uma versão de dados para a próxima enquanto os nomes permanecerem.

curl 'https://open.wenmarpro.com/v1/vehicles/search?q=2019+civic+si'
curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic_si

Tudo para um veículo

Uma resposta com tudo o que este servidor possui para um ano-modelo, solicitada por id de veículo ou por VIN, com links para suas páginas. Um bloco para o qual o servidor não tem dados é null, então a resposta tem os mesmos membros em todos os servidores. Os recalls nela são uma contagem das campanhas que listam o ano, a marca e o modelo, com os três mais recentes; a lista completa tem seu próprio endereço. O terceiro endereço lista todos os anos-modelo de um modelo, do mais recente para o mais antigo.

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

Campanhas de recall da NHTSA, para os Estados Unidos, e da Transport Canada, do mais recente para o mais antigo. Uma campanha lista um ano, uma marca e um modelo, então um recall listado aqui pode se aplicar a um veículo daquele ano-modelo. Somente o fabricante pode dizer se ele se aplica a um veículo específico: toda resposta tem may_apply definido como true e um objeto de consulta com as consultas oficiais por VIN.

O último endereço lista as campanhas reportadas em ou após um dia, cada uma com os veículos que lista. Adicione country=us ou country=ca para um único país. as_of é o dia em que os dados de cada país estavam atualizados, e attribution contém o crédito que a licença dos dados exige. Um servidor executado sem dados de recall responde a esses endereços com 404 e o 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'

Classificações de teste de colisão

As classificações de teste de colisão da NHTSA para um ano-modelo, do seu New Car Assessment Program. A NHTSA classifica um veículo por estilo de carroceria e tração, então a resposta frequentemente tem várias classificações e suas estrelas podem diferir: cada uma diz para qual veículo é, nas palavras da NHTSA, e nenhuma é escolhida por você. Uma classificação sem estrelas é um veículo que a NHTSA lista e não testou.

as_of é o dia em que o arquivo da NHTSA estava atualizado. A mesma resposta é o membro safety da visão geral de um veículo. Um servidor executado sem as classificações responde a este endereço com 404 e o código dataset_unavailable.

curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic/safety

Combustível, especificações, fluidos e pneus

O que é mantido sobre um ano-modelo além de seus recalls: classificações de consumo de combustível da EPA e da Natural Resources Canada, especificações dos arquivos da EPA, o grau de óleo do motor que a EPA registra com os fluidos que uma pessoa leu dos próprios documentos do fabricante, e os pneus originais de fábrica. Cada um tem um endereço para um id de veículo e um para um VIN, como /v1/vin/{vin}/fuel.

Um valor nunca é dado com mais precisão do que foi correspondido: confidence diz model, engine ou submodel, e um motor é nomeado apenas onde a correspondência o definiu. Por VIN, combustível, especificações e fluidos contêm apenas o que é para o motor decodificado quando a decodificação o define, e engine_settled diz isso. Os pneus nunca são restringidos. Um registro lido manualmente carrega sua fonte e o dia em que foi verificado, e uma lista vazia significa que ninguém o registrou: nada é estimado.

Este servidor contém: /v1/vehicles/{id}/fuel, /v1/vehicles/{id}/specs, /v1/vehicles/{id}/fluids. Um endereço que ele não contém responde 404 com o código dataset_unavailable.

curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic/fuel

O que os proprietários relatam

O que os proprietários relataram à NHTSA sobre um ano-modelo, como contagens por componente com a quilometragem mediana que informaram: são relatos de proprietários, não verificados, e uma contagem não é uma taxa. Um servidor executado sem as reclamações responde a este endereço com 404 e o código dataset_unavailable.

curl https://open.wenmarpro.com/v1/vehicles/2019_honda_civic/complaints

Erros

Um erro é um objeto JSON com um membro, error, que tem um code, uma message e details. O status HTTP é o sinal principal.

400 invalid_vin: comprimento errado ou caracteres ilegais; details.suggestions lista correções prováveis. 400 validation_failed: um parâmetro ou corpo está ausente ou errado. 404 not_found: nenhum fabricante está registrado para os três primeiros caracteres do VIN, ou nenhum veículo tem esse id. 429 rate_limited: muitas solicitações. 500 internal_error: culpa nossa.

Limites

Um endereço pode fazer 600 solicitações por minuto. Isso é muito mais do que uma oficina precisa, e existe apenas para que um único cliente não possa atrasar o serviço para todos. Acima disso, a resposta é 429 com um cabeçalho Retry-After informando quantos segundos esperar.

Um lote contém no máximo 50 VINs. Um corpo de solicitação pode ter no máximo 16 KB.

Cache e versões

Toda resposta carrega a versão dos dados em um cabeçalho X-Data-Version. As respostas não mudam até que os dados mudem, então GETs bem-sucedidos podem ser armazenados em cache por um dia e carregam um ETag; envie-o de volta em If-None-Match para obter um 304.

Campos e endpoints são apenas adicionados. Nada que foi lançado é removido ou recebe um novo significado.

Para agentes de IA

Um assistente que pode buscar um endereço web pode decodificar um VIN com uma solicitação. Não há chave para solicitar e nada para se cadastrar.

A resposta é JSON: o ano, marca, modelo, versão, motor e equipamentos de segurança, e uma lista de avisos. Um dígito verificador incorreto é um aviso, não um erro.

curl https://open.wenmarpro.com/v1/vin/KM8K2CAB4PU001140

Servidor MCP

As mesmas consultas são ferramentas em um servidor Model Context Protocol: wenmar_vin, wenmar_vehicles, wenmar_recalls e wenmar_bulletins. Um recall que wenmar_recalls lista pode se aplicar a um veículo daquele ano, marca e modelo; somente o fabricante pode confirmá-lo para um VIN específico. Um boletim que wenmar_bulletins lista é para um ano-modelo e não é um recall. O servidor fala Streamable HTTP e não requer chave. Adicione este endereço como um servidor remoto ou um conector personalizado:

https://open.wenmarpro.com/mcp