Référence API · Décodage

Décodage VIN

Année, marque, modèle, finition, moteur, carrosserie et plus à partir d’un VIN de 17 caractères.

GET https://api.autoparse.io/v1/vin/decode/{vin}

1 crédit par requête réussie. Les recherches échouées ne sont pas facturées.

Nouveau sur cet endpoint ? Lisez la présentation : API de décodage VIN.

Présentation

L’endpoint de décodage VIN lit un numéro d’identification de véhicule de 17 caractères et renvoie les caractéristiques qui y sont codées : constructeur, année modèle, finition, moteur, boîte, transmission, carrosserie, usine d’assemblage et équipements de sécurité. Chaque champ est normalisé et structuré : vous pouvez le stocker, le rechercher et l’afficher sans analyser de texte libre.

Cas d’usage courants

Préremplir année, marque, modèle et finition dès qu’un vendeur ou un client saisit un VIN
Valider et normaliser les VIN avant leur entrée dans votre base de données
Alimenter la recherche et le filtrage par carrosserie, transmission, carburant ou usine

Champs de réponse

Champ	Description
`vin`	Le VIN soumis, renvoyé sous forme normalisée en majuscules.
`year, make, model, trim`	Identification de base du véhicule tel que construit, y compris la finition.
`engine`	Modèle de moteur, constructeur, carburant, cylindres et cylindrée en litres et pouces cubes.
`transmission`	Type de boîte de vitesses, par exemple automatique ou manuelle.
`drivetrain`	Roues motrices : FWD, RWD, AWD ou 4WD.
`exterior`	Type de carrosserie, nombre de portes et poids total autorisé en charge.
`plant`	Usine où le véhicule a été assemblé, ville et pays.
`safety`	Ceintures, surveillance de la pression des pneus et airbags par rangée.

Paramètres

Nom	Emplacement	Type	Description
`vin`obligatoire	path	string	17-character Vehicle Identification Number. ^[A-HJ-NPR-Z0-9]{17}$ ex. `2G1FK1EJ6A9133857`

Requête

cURL

curl "https://api.autoparse.io/v1/vin/decode/2G1FK1EJ6A9133857" \
  -H "x-api-key: $AUTOPARSE_API_KEY"

Réponse

200 OK

{
  "vin": "2G1FK1EJ6A9133857",
  "body": "Coupe",
  "make": "Chevrolet",
  "trim": "2SS",
  "year": 2010,
  "model": "Camaro",
  "plant": "Oshawa, Ontario, Canada",
  "engine": {
    "fuel": "Gasoline",
    "model": "L99",
    "cylinders": 8,
    "injection": "Sequential Fuel Injection (SFI)",
    "other_info": "Alum",
    "manufacturer": "GM",
    "displacement_l": 6.2,
    "displacement_cc": "6,200 cc",
    "displacement_ci": "378.35 ci"
  },
  "safety": {
    "tpms": "Direct",
    "air_bags": {
      "side": "1st Row (Driver And Passenger)",
      "front": "1st Row (Driver And Passenger)",
      "curtain": "All Rows"
    },
    "seat_belts": "Manual"
  },
  "exterior": {
    "gvwr": "Class 1: 6,000 Lb Or Less (2,722 Kg Or Less)",
    "doors": 2
  },
  "manufacturer": "General Motors LLC",
  "transmission": {
    "style": "Automatic"
  },
  "vehicle_type": "Passenger Car"
}

Erreurs

Réponses courantes : 400 paramètre invalide, 401 clé incorrecte, 402 crédits insuffisants, 404 aucune donnée, 429 limite de débit atteinte. Voir Erreurs pour la liste complète.