Documentation de l'API

Tout ce qu'il faut pour interroger l'API plaque d'immatriculation et l'API VIN Decoder depuis votre code.

Authentification

Les API (plaque, VIN et simulateur carte grise) sont distribuées via RapidAPI. Chaque requête doit contenir deux en-têtes HTTP :

x-rapidapi-key — Votre clé personnelle, visible dans le tableau de bord RapidAPI.
x-rapidapi-host — Host de l'API appelée (plaque, VIN ou simulateur).

API Plaque d'immatriculation (SIV)

Renvoie les caractéristiques techniques d'un véhicule immatriculé en France à partir de sa plaque.

Base URL

https://api-plaque-immatriculation-siv.p.rapidapi.com

Endpoint

GET /get-vehicule-info?immatriculation={immatriculation}

Paramètre

immatriculation — Plaque d'immatriculation française (SIV AA-123-AA ou ancien format FNI)

En-têtes d'authentification

Headers

x-rapidapi-host: api-plaque-immatriculation-siv.p.rapidapi.com
x-rapidapi-key: VOTRE_CLE_RAPIDAPI

Exemples de requête

curl --request GET \
  --url 'https://api-plaque-immatriculation-siv.p.rapidapi.com/get-vehicule-info?immatriculation=AA123NC' \
  --header 'x-rapidapi-host: api-plaque-immatriculation-siv.p.rapidapi.com' \
  --header 'x-rapidapi-key: VOTRE_CLE_RAPIDAPI'

Exemple de réponse JSON

200 OK — application/json

{
  "data": {
    "erreur": "",
    "immat": "AA123NC",
    "pays": "FR",
    "marque": "PEUGEOT",
    "modele": "207",
    "modele_en": "207 SW",
    "version": "SW 1.6",
    "debut_modele": "2007-06",
    "fin_modele": "2012-12",
    "date1erCir_us": "2009-05-12",
    "date1erCir_fr": "12-05-2009",
    "co2": "",
    "energie": "2",
    "energieNGC": "DIESEL",
    "type_moteur": "Diesel",
    "genreVCG": "1",
    "genreVCGNGC": "VP",
    "puisFisc": "5",
    "carrosserieCG": "BREAK",
    "code_carrosserie": "28",
    "carrosserie": "Break",
    "code_type_transmission": "1",
    "type_transmission": "Traction avant",
    "capacite_litres": "1.60",
    "code_systeme_alimentation": "11",
    "systeme_alimentation": "Injection directe",
    "valves": "4",
    "puisFiscReelKW": "66 KW",
    "puisFiscReelCH": "90 CH",
    "collection": "",
    "vin": "VF3WE9HXC9W040029",
    "variante": "WE9HXC",
    "boite_vitesse": "M",
    "code_boite_vitesse": "",
    "nr_passagers": "5",
    "nb_portes": "0",
    "type_mine": "MPE5214TP747",
    "cnit": "MPE5214TP747",
    "couleur": "",
    "poids": "1741 KG",
    "ptac": "1741 KG",
    "ccm": "1560 CM3",
    "cylindres": "4",
    "propulsion": "",
    "type_compression": "",
    "longueur": "",
    "largeur": "",
    "hauteur": "",
    "empattement": "",
    "sra_id": "PE37185",
    "sra_group": "30",
    "sra_commercial": "SW 1.6 HDI 90 ACTIVE",
    "numero_serie": "9W040029",
    "logo_marque": "https://api.apiplaqueimmatriculation.com/public/storage/photos_marques/88.png?v=1",
    "photo_modele": "https://api.apiplaqueimmatriculation.com/public/storage/photos_modeles/23388.jpg",
    "k_type": "23388",
    "tecdoc_manu_id": "88",
    "tecdoc_model_id": "6433",
    "tecdoc_car_id": "23388",
    "tecdoc_vehicules_compatible": "",
    "code_moteur": "9HV_(DV6TED4BU),9HX_(DV6ATED4),9HV_(DV6TED4),9HV_(DV6TED4B)",
    "codes_platforme": "",
    "liste_sra_commercial": null,
    "pneus": [
      {
        "name": "205/45 R 17",
        "width": 205,
        "height": 45,
        "diameter": 17,
        "load_index": 88,
        "speed_index": "V"
      },
      {
        "name": "195/55 R 16",
        "width": 195,
        "height": 55,
        "diameter": 16,
        "load_index": 87,
        "speed_index": "V"
      },
      {
        "name": "205/55 R 16",
        "width": 205,
        "height": 55,
        "diameter": 16,
        "load_index": 91,
        "speed_index": "V"
      },
      {
        "name": "185/65 R 15",
        "width": 185,
        "height": 65,
        "diameter": 15,
        "load_index": 88,
        "speed_index": "H"
      }
    ]
  },
  "api_version": "V1",
  "message": "",
  "code_erreur": 200
}

API VIN Decoder

Décode un numéro VIN et renvoie la fiche technique du véhicule (constructeur, modèle, motorisation, références TecDoc, pneus) ainsi que la plaque associée lorsqu'elle est connue.

Base URL

https://api-vin-decoder.p.rapidapi.com

Endpoint

GET /vin?vin={vin}

Paramètre

vin — Numéro VIN à 17 caractères (sans I, O ni Q)

En-têtes d'authentification

Headers

x-rapidapi-host: api-vin-decoder.p.rapidapi.com
x-rapidapi-key: VOTRE_CLE_RAPIDAPI

Exemples de requête

curl --request GET \
  --url 'https://api-vin-decoder.p.rapidapi.com/vin?vin=VF1DZ0N0641118804' \
  --header 'x-rapidapi-host: api-vin-decoder.p.rapidapi.com' \
  --header 'x-rapidapi-key: VOTRE_CLE_RAPIDAPI'

Exemple de réponse JSON

200 OK — application/json

{
  "data": {
    "erreur": "",
    "vin": "VF1DZ0N0641118804",
    "pays": "FR",
    "plaque": "AA123BC",
    "marque": "RENAULT",
    "modele": "MEGANE III",
    "modele_en": "MEGANE III Coupe",
    "version": "1.9 dCi",
    "debut_modele": "2008-11",
    "fin_modele": "2015-08",
    "date1erCir_fr": "18-04-2009",
    "variante": "DZ0N06",
    "co2": "",
    "energie": "2",
    "energieNGC": "DIESEL",
    "type_moteur": "Diesel",
    "genreVCG": "1",
    "genreVCGNGC": "VP",
    "puisFisc": "7",
    "carrosserieCG": "COUPE",
    "code_carrosserie": "29",
    "carrosserie": "Coupé",
    "code_type_transmission": "1",
    "type_transmission": "Traction avant",
    "capacite_litres": "1.90",
    "code_systeme_alimentation": "11",
    "systeme_alimentation": "Injection directe",
    "valves": "2",
    "boite_vitesse": "M",
    "code_boite_vitesse": "",
    "puisFiscReelKW": "96 KW",
    "puisFiscReelCH": "131 CH",
    "nr_passagers": "5",
    "nb_portes": "0",
    "type_mine": "MRE5531A0421",
    "cnit": "MRE5531A0421",
    "couleur": "",
    "poids": "1807 KG",
    "ptac": "1807 KG",
    "ccm": "1870 CM3",
    "cylindres": "4",
    "propulsion": "",
    "type_compression": "",
    "longueur": "",
    "largeur": "",
    "hauteur": "",
    "empattement": "",
    "sra_id": "RE80126",
    "sra_group": "32",
    "sra_commercial": "1.9 dCi (DZ0N, DZ0J, DZ1J, DZ1K)",
    "numero_serie": "41118804",
    "logo_marque": "https://api.apiplaqueimmatriculation.com/public/storage/photos_marques/93.png?v=1",
    "photo_modele": "https://api.apiplaqueimmatriculation.com/public/storage/photos_modeles/31164.jpg",
    "k_type": "31164",
    "tecdoc_manu_id": "93",
    "tecdoc_model_id": "7867",
    "tecdoc_car_id": "31164",
    "tecdoc_vehicules_compatible": "",
    "code_moteur": "F9Q(870|872)",
    "codes_platforme": "DZ0/1_",
    "pneus": [
      {
        "name": "205/50 R 17",
        "width": 205,
        "height": 50,
        "diameter": 17,
        "load_index": 89,
        "speed_index": "V"
      },
      {
        "name": "205/55 R 16",
        "width": 205,
        "height": 55,
        "diameter": 16,
        "load_index": 91,
        "speed_index": "H"
      }
    ]
  },
  "api_version": "*",
  "message": "",
  "code_erreur": 200
}

API Simulateur prix carte grise

Calcule le prix d'une carte grise (taxes Y1 à Y5 et total) à partir de la plaque, du département et de la démarche, et renvoie les caractéristiques du véhicule utilisées pour le calcul.

Base URL

https://api-simulation-du-cout-de-carte-grise-en-france.p.rapidapi.com

Endpoint

GET /simulateur-cg?immatriculation={immatriculation}

Paramètre

immatriculation — Plaque d'immatriculation française

En-têtes d'authentification

Headers

x-rapidapi-host: api-simulation-du-cout-de-carte-grise-en-france.p.rapidapi.com
x-rapidapi-key: VOTRE_CLE_RAPIDAPI

Exemples de requête

curl --request GET \
  --url 'https://api-simulation-du-cout-de-carte-grise-en-france.p.rapidapi.com/simulateur-cg?immatriculation=FV-146-AZ&departement=27&demarche=1' \
  --header 'x-rapidapi-host: api-simulation-du-cout-de-carte-grise-en-france.p.rapidapi.com' \
  --header 'x-rapidapi-key: VOTRE_CLE_RAPIDAPI'

Paramètres requis : immatriculation, departement et demarche. Codes des démarches et mode manuel : voir la page Simulateur carte grise.

Exemple de réponse JSON

200 OK — application/json

{
  "data": {
    "plaque": "fv146az",
    "departement": "27",
    "demarche": "1",
    "tarif": {
      "y1": 360,
      "y2": 0,
      "y3": 0,
      "y4": 11,
      "y5": 2.76,
      "y1bis": 0,
      "total": 373.76,
      "error": false
    },
    "vehicule": {
      "erreur": "",
      "immat": "fv146az",
      "co2": "157",
      "energie": "4",
      "energieNGC": "ESSENCE",
      "genreVCG": "2",
      "genreVCGNGC": "CTTE",
      "puisFisc": "6",
      "carrosserieCG": "FOURGON",
      "marque": "TOYOTA",
      "modele": "PROACE CITY",
      "date1erCir_us": "2020-11-10",
      "date1erCir_fr": "10-11-2020",
      "collection": "non",
      "vin": "YAREUHNP2GJ940063",
      "boite_vitesse": "M",
      "puisFiscReel": "110 KW",
      "nr_passagers": "3",
      "nb_portes": "3",
      "type_mine": "N10JT0CT035H883",
      "couleur": "NOIR",
      "poids": "1960 kg",
      "cylindres": "3",
      "sra_id": "TO49001",
      "sra_group": "30",
      "sra_commercial": "MEDIUM 1.2 110 VVT-I ACTIVE",
      "logo_marque": "https://api.apiplaqueimmatriculation.com/public/storage/logos_marques/?marque=toyota",
      "k_type": "139226",
      "tecdoc_carid": "139226",
      "tecdoc_manuid": "111",
      "tecdoc_modelid": "40403",
      "code_moteur": "EB2ADT_HNP"
    }
  },
  "api-version": "1.0.0"
}

Champs de réponse

Toutes les valeurs sont renvoyées sous forme de chaînes de caractères dans l'objet data. Une donnée indisponible peut être absente, vide ou valoir "INCONNU".

Identification

Champ	Type	Exemple	Description
immat	string	AA123NC	Plaque d'immatriculation normalisée, sans tirets.
plaque	string	AA123NC	Plaque d'immatriculation associée au VIN (réponse de l'API VIN).
pays	string	FR	Pays d'immatriculation (code ISO).
vin	string	VF3WE9HXC9W040029	Numéro d'identification du véhicule (17 caractères, champ E de la carte grise).
type_mine	string	MPE5214TP747	Type variante version (champ D.2 de la carte grise).
cnit	string	MPE5214TP747	Code national d'identification du type (champ D.2.1).
numero_serie	string	9W040029	Partie séquentielle du VIN attribuée par le constructeur.
variante	string	WE9HXC	Code variante constructeur.
k_type	string	23388	Identifiant TecDoc du véhicule, utilisé pour la compatibilité des pièces.
tecdoc_car_id	string	23388	Identifiant véhicule dans le catalogue TecDoc.
tecdoc_manu_id	string	88	Identifiant du constructeur dans TecDoc.
tecdoc_model_id	string	6433	Identifiant de la gamme / du modèle dans TecDoc.
sra_id	string	PE37185	Code de classification SRA (Sécurité et Réparation Automobiles).
sra_group	string	30	Groupe de tarification assurance SRA.
codes_platforme	string	WK_	Codes plateforme constructeur, lorsqu'ils sont disponibles.

Général

Champ	Type	Exemple	Description
marque	string	PEUGEOT	Marque du véhicule (champ D.1).
modele	string	207	Dénomination commerciale du modèle (champ D.3).
modele_en	string	207 SW	Libellé du modèle incluant la carrosserie.
version	string	SW 1.6	Version du véhicule.
sra_commercial	string	SW 1.6 HDI 90 ACTIVE	Libellé commercial complet de la version et de la finition.
date1erCir_fr	string	12-05-2009	Date de première immatriculation au format JJ-MM-AAAA (champ B).
date1erCir_us	string	2009-05-12	Date de première immatriculation au format AAAA-MM-JJ.
debut_modele	string	2007-06	Mois de lancement de la génération du modèle.
fin_modele	string	2012-12	Mois de fin de commercialisation de la génération.
couleur	string	GRIS	Couleur dominante déclarée, lorsqu'elle est disponible.
carrosserie	string	Break	Type de carrosserie en clair.
carrosserieCG	string	BREAK	Carrosserie telle que désignée sur la carte grise (champ J.3).
code_carrosserie	string	28	Code numérique du type de carrosserie.
genreVCGNGC	string	VP	Genre national (champ J.1), ex. VP = véhicule particulier.
genreVCG	string	1	Code numérique du genre.
collection	string		Indique si le véhicule est immatriculé en collection.

Moteur

Champ	Type	Exemple	Description
energieNGC	string	DIESEL	Carburant / source d'énergie (champ P.3).
energie	string	2	Code numérique de l'énergie.
type_moteur	string	Diesel	Type de motorisation en clair.
puisFisc	string	5	Puissance administrative en chevaux fiscaux (champ P.6).
puisFiscReelKW	string	66 KW	Puissance nette maximale en kilowatts (champ P.2).
puisFiscReelCH	string	90 CH	Puissance en chevaux.
ccm	string	1560 CM3	Cylindrée en cm³ (champ P.1).
capacite_litres	string	1.60	Cylindrée exprimée en litres.
cylindres	string	4	Nombre de cylindres.
valves	string	4	Nombre de soupapes par cylindre.
systeme_alimentation	string	Injection directe	Système d'alimentation du moteur.
code_systeme_alimentation	string	11	Code numérique du système d'alimentation.
code_moteur	string	9HV_(DV6TED4BU),9HX_(DV6ATED4)	Code(s) moteur constructeur ; plusieurs codes possibles, séparés par des virgules.
type_compression	string		Type de compression / suralimentation, lorsqu'il est disponible.
propulsion	string		Type de propulsion, lorsqu'il est disponible.

Transmission

Champ	Type	Exemple	Description
boite_vitesse	string	M	Type de boîte : M = manuelle, A = automatique.
code_boite_vitesse	string		Code constructeur de la boîte de vitesses, lorsqu'il est disponible.
type_transmission	string	Traction avant	Roues motrices (traction, propulsion, intégrale).
code_type_transmission	string	1	Code numérique du type de transmission.

Dimensions & poids

Champ	Type	Exemple	Description
nb_portes	string	5	Nombre de portes (peut valoir 0 si non renseigné).
nr_passagers	string	5	Nombre de places assises (champ S.1).
poids	string	1741 KG	Masse du véhicule, avec unité.
ptac	string	1741 KG	Poids total autorisé en charge (champ F.2), avec unité.
longueur	string		Longueur hors tout, lorsqu'elle est disponible.
largeur	string		Largeur hors tout, lorsqu'elle est disponible.
hauteur	string		Hauteur, lorsqu'elle est disponible.
empattement	string		Distance entre les essieux, lorsqu'elle est disponible.

Environnement

Champ	Type	Exemple	Description
co2	string	104	Émissions de CO₂ en g/km (champ V.7), lorsqu'elles sont disponibles.

Images, pneus et listes

Champ	Type	Description
logo_marque	string (URL)	URL du logo de la marque.
photo_modele	string (URL)	URL d'une photo représentative du modèle.
pneus	array	Dimensions de pneus homologuées : name, width, height, diameter, load_index, speed_index.
liste_sra_commercial	array \| null	Liste des versions commerciales possibles lorsque l'identification est ambiguë.
tecdoc_vehicules_compatible	string	Véhicules TecDoc compatibles, lorsqu'ils sont disponibles.

Enveloppe de réponse : data (fiche véhicule), code_erreur (200 en cas de succès), message et api_version.

Codes d'erreur

Code	Statut	Signification
200	OK	Requête réussie : les données du véhicule sont dans l'objet data.
400	Requête invalide	Paramètre manquant ou mal formé (plaque ou VIN au mauvais format).
401	Non authentifié	Clé RapidAPI absente, invalide ou abonnement inactif.
404	Véhicule introuvable	Aucun véhicule ne correspond à la plaque ou au VIN fourni.
429	Trop de requêtes	Quota mensuel de votre offre atteint ou limite de débit dépassée.
500	Erreur serveur	Erreur temporaire côté source de données : réessayez quelques secondes plus tard.

Besoin d'exemples dans d'autres langages ? Consultez les exemples de code.

Testez l'API plaque d'immatriculation gratuitement

10 requêtes offertes chaque mois, sans engagement. Votre clé est disponible immédiatement sur RapidAPI.

Obtenir ma clé API Tester la démo