Documentation

Documentation de l'API ImmatriculationAuto

Tout ce qu'il faut pour intégrer la recherche de véhicule par plaque : endpoint, authentification, structure de réponse, codes d'erreur et exemples prêts à copier. La clé s'obtient en quelques minutes sur RapidAPI, où l'API est référencée sous le nom AutoVerif France.

Endpoint

HTTP

GET https://autoverif-france.p.rapidapi.com/api/lookup/{plaque}

Paramètre `plaque`	Plaque française au format SIV (AA-123-AA) ou FNI (123-ABC-75). Tirets, espaces et casse indifférents : FK188PD, fk-188-pd et FK 188 PD sont équivalents.
En-tête `x-rapidapi-host`	autoverif-france.p.rapidapi.com
En-tête `x-rapidapi-key`	Votre clé personnelle, générée par RapidAPI à la souscription.
Format de réponse	JSON, UTF-8, libellés de données en français.

Réponse complète

Exemple réel pour la plaque FK-188-PD. Chaque champ peut être vide selon les données disponibles pour le véhicule : prévoyez des valeurs par défaut côté client.

200 OK · JSON

{
  "success": true,
  "data": {
    "vehicle": {
      "licenseplate": "FK188PD",
      "brand": "MERCEDES",
      "model": "CLASSE S",
      "year": "2019",
      "logo": "https://cdn.vincommon.com/logos/mercedes.svg",
      "marketprice": ""
    },
    "identification": {
      "numero_dimmatriculation": "FK188PD",
      "numero_didentification_vehicule_vin": "WDD2229861A518867",
      "finition": "560 4M",
      "couleur": "Gris",
      "couleur_interieure": "LEATHER EXCLUSIVE",
      "carrosserie": "Conduite intérieure / CI",
      "type": "Voitures particulières / VP",
      "portes_places_assises": "4 / 4"
    },
    "specifications": {
      "highlighted": {
        "couleur": "Gris",
        "carburant": "Essence",
        "cylindree": "3982 cm³",
        "boite_de_vitesses": "Automatique"
      },
      "engine": {
        "cylindre": "3982 cm³ 4 l",
        "puissance": "345 kW 469 ch",
        "couple": "700 Nm",
        "puissancefiscale": "36 CV",
        "cylindres": "8",
        "vitessemaximale": "250 km/h"
      },
      "transmission": {
        "botedevitesses": "Automatique",
        "vitesses": "9",
        "traction": "4 roues permanent"
      },
      "fuel": {
        "type": "Essence",
        "consommationmixte": "9.8 l/100km"
      },
      "body": {
        "type": "Conduite intérieure / CI",
        "doors": "4",
        "seats": "4"
      }
    },
    "history": {
      "timeline": [
        { "date": "2019-04", "event": "Fabriquée", "formatted": "2019-04: Fabriquée" },
        { "date": "2019-10-01", "event": "Mise en circulation", "formatted": "2019-10-01: Mise en circulation" },
        { "date": null, "event": "Immatriculation", "formatted": "Immatriculation" },
        { "date": "2023", "event": "Achat ou reprise par un professionnel", "formatted": "2023: Achat ou reprise par un professionnel" },
        { "date": null, "event": "Changement de titulaire", "formatted": "Changement de titulaire" }
      ],
      "age": "6 ans et 10 mois"
    },
    "summary": {
      "fullname": "MERCEDES CLASSE S (2019)",
      "basicspecs": "couleur: Gris • carburant: Essence • cylindree: 3982 cm³ • boite_de_vitesses: Automatique",
      "ageandprice": "6 ans et 10 mois"
    }
  },
  "metadata": {
    "licenseplate": "FK188PD",
    "timestamp": "2026-08-17T16:36:58.429Z"
  }
}

Codes d'erreur

Code HTTP	Signification	Conduite à tenir
200	Véhicule trouvé, `success: true`	Exploiter le bloc `data`
400	Format de plaque invalide	Valider la saisie côté client avant l'appel
401 / 403	Clé absente, invalide ou non abonnée	Vérifier les en-têtes RapidAPI et la souscription
404	Aucun véhicule pour cette plaque	Proposer une correction de saisie à l'utilisateur
429	Quota du plan dépassé	Temporiser (backoff) ou passer au plan supérieur
5xx	Erreur temporaire du service	Réessayer avec délai progressif, ne pas mettre en cache

Exemples d'intégration

cURL

bash

curl "https://autoverif-france.p.rapidapi.com/api/lookup/FK188PD" \
  -H "x-rapidapi-host: autoverif-france.p.rapidapi.com" \
  -H "x-rapidapi-key: VOTRE_CLE"

PHP (Laravel HTTP Client)

php

use Illuminate\Support\Facades\Http;

$reponse = Http::withHeaders([
    'x-rapidapi-host' => 'autoverif-france.p.rapidapi.com',
    'x-rapidapi-key' => config('services.rapidapi.key'),
])->get('https://autoverif-france.p.rapidapi.com/api/lookup/FK188PD');

if ($reponse->successful() && $reponse->json('success')) {
    $vehicule = $reponse->json('data.vehicle');
    // $vehicule['brand'] => "MERCEDES"
}

Python (requests)

python

import requests

reponse = requests.get(
    "https://autoverif-france.p.rapidapi.com/api/lookup/FK188PD",
    headers={
        "x-rapidapi-host": "autoverif-france.p.rapidapi.com",
        "x-rapidapi-key": "VOTRE_CLE",
    },
    timeout=10,
)

donnees = reponse.json()
if donnees.get("success"):
    print(donnees["data"]["vehicle"]["brand"])  # MERCEDES

Node.js (fetch)

javascript

const reponse = await fetch(
  "https://autoverif-france.p.rapidapi.com/api/lookup/FK188PD",
  {
    headers: {
      "x-rapidapi-host": "autoverif-france.p.rapidapi.com",
      "x-rapidapi-key": process.env.RAPIDAPI_KEY,
    },
  }
);

const donnees = await reponse.json();
if (donnees.success) {
  console.log(donnees.data.vehicle.brand); // MERCEDES
}

Bonnes pratiques

Validez la plaque côté client avant l'appel : le format SIV exclut les lettres I, O et U, ce qui élimine la majorité des fautes de frappe.
Mettez les réponses en cache : les caractéristiques techniques d'un véhicule ne changent pas. Un cache persistant par plaque économise votre quota, c'est exactement ainsi que fonctionne ce site.
Traitez les champs vides comme une absence de donnée, pas comme une erreur.
Ne stockez jamais la clé côté navigateur : proxifiez les appels par votre backend.

Obtenir une clé Explorer les cas d'usage