API carte grise : récupérer les données d'un véhicule à partir de la plaque
Découvrez comment une API carte grise permet de récupérer automatiquement les principales données d'un véhicule français à partir de sa plaque d'immatriculation.
Lorsqu'une application automobile doit identifier rapidement un véhicule, demander à l'utilisateur de recopier manuellement toutes les informations présentes sur une carte grise n'est pas toujours la meilleure solution. Une API carte grise permet d'utiliser la plaque d'immatriculation comme point d'entrée afin de récupérer automatiquement les données véhicule disponibles et de préremplir un formulaire, un dossier client ou une fiche technique.
Cette approche est particulièrement utile pour les services de carte grise, garages, assureurs, vendeurs de pièces, gestionnaires de flotte et plateformes automobiles qui doivent traiter régulièrement des véhicules immatriculés en France.
Qu'est-ce qu'une API carte grise ?
Une API carte grise est une interface permettant à un logiciel d'obtenir automatiquement des informations liées à un véhicule à partir d'un identifiant, le plus souvent son numéro d'immatriculation.
Dans le cas de l'API Plaque Immatriculation France proposée sur api-plaque.com, l'application envoie une requête HTTP vers l'endpoint GET /fr avec le paramètre plaque.
Le parcours est simple :
- l'utilisateur saisit sa plaque d'immatriculation ;
- votre application appelle l'API ;
- l'API retourne les données véhicule disponibles au format JSON ;
- votre logiciel exploite ces données pour préremplir ou vérifier un formulaire.
L'API ne remplace pas un document administratif officiel et ne délivre pas de certificat d'immatriculation. Elle sert à identifier techniquement un véhicule et à récupérer des informations structurées à partir de sa plaque.
Quelles données véhicule peut-on récupérer ?
Selon les informations disponibles pour le véhicule interrogé, la réponse peut notamment contenir :
- la marque ;
- le modèle ;
- la version ;
- le VIN ;
- la date de première mise en circulation ;
- le carburant ;
- la puissance en chevaux ;
- la puissance en kW ;
- la puissance fiscale ;
- la cylindrée ;
- le code moteur ;
- le type de carrosserie ;
- les émissions de CO₂ ;
- certaines références techniques complémentaires comme le K-Type lorsqu'elles sont disponibles.
La présence de chaque champ dépend du véhicule et des données disponibles. Une intégration fiable doit donc toujours vérifier qu'une valeur existe avant de l'utiliser.
API carte grise et plaque d'immatriculation : quel intérêt pour un professionnel ?
L'avantage principal est de réduire la saisie manuelle.
Au lieu de demander à un utilisateur de sélectionner successivement :
Marque → modèle → version → carburant → puissance → année
vous pouvez proposer un parcours plus court :
Plaque → véhicule identifié → confirmation
Cette logique permet de simplifier les formulaires, d'améliorer la cohérence des données collectées et d'accélérer les traitements internes.
Cas d'usage n°1 : service de carte grise en ligne
Une plateforme de démarches automobiles peut utiliser une API d'immatriculation dès le début du parcours client.
Par exemple :
- le client saisit sa plaque ;
- la plateforme récupère les données véhicule disponibles ;
- le formulaire affiche la marque, le modèle, la date de mise en circulation ou la puissance fiscale ;
- le client confirme les informations ;
- le processus administratif continue avec les justificatifs nécessaires.
L'API ne remplace pas les contrôles réglementaires ni les documents requis, mais elle peut éviter à l'utilisateur de ressaisir des informations techniques déjà disponibles.
Cas d'usage n°2 : préremplir un formulaire automobile
Les formulaires automobiles deviennent rapidement longs lorsqu'ils demandent plusieurs caractéristiques du véhicule.
Une API carte grise peut servir à préremplir automatiquement une partie de ces champs dans :
- un formulaire de devis ;
- un dossier de reprise ;
- une demande d'assurance ;
- une prise de rendez-vous garage ;
- un formulaire de vente automobile ;
- un outil de gestion de flotte.
Le véhicule doit néanmoins rester visible et confirmable par l'utilisateur avant validation définitive.
Cas d'usage n°3 : vérifier les données d'un véhicule
Dans une application métier, l'API peut aussi être utilisée comme outil de vérification.
Supposons qu'un utilisateur ait déjà renseigné :
RENAULT
CLIO
Diesel
2019
Une requête sur la plaque permet de comparer ces valeurs aux données retournées et de détecter une incohérence avant d'enregistrer le dossier.
Cette vérification peut être utile pour éviter les erreurs de version, de motorisation ou d'année dans les bases clients.
Cas d'usage n°4 : enrichir une base véhicule
Une entreprise qui dispose déjà d'une liste de plaques peut utiliser une API pour enrichir progressivement sa base avec des caractéristiques techniques structurées.
Par exemple, une base minimale :
plaque
client_id
peut devenir :
plaque
marque
modele
version
vin
energie
puissance_fiscale
code_moteur
date_mise_en_circulation
client_id
Cette structuration facilite ensuite la recherche interne, le reporting, les campagnes d'entretien ou les règles métier basées sur les caractéristiques du véhicule.
Exemple de requête API
L'endpoint utilisé pour une plaque française est :
GET /fr?plaque=FH034DD
Via RapidAPI, une requête curl peut prendre cette forme :
curl -G \
"https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co/fr" \
-H "x-rapidapi-key: VOTRE_CLE_RAPIDAPI" \
-H "x-rapidapi-host: https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co" \
-d "plaque=FH034DD"
La réponse est retournée au format JSON et peut ensuite être utilisée dans votre application.
Pour aller plus loin, consultez la documentation de l'API ainsi que notre guide consacré à l'intégration d'une API plaque d'immatriculation dans une application métier.
Exemple de données retournées
Une réponse peut contenir des champs de ce type :
{
"AWN_marque": "RENAULT",
"AWN_modele": "CLIO",
"AWN_version": "1.5 dCi 90",
"AWN_VIN": "VF1R9800962986572",
"AWN_date_mise_en_circulation": "20-06-2019",
"AWN_energie": "GAZOLE",
"AWN_puissance_fiscale": "5",
"AWN_code_moteur": "K9K_638"
}
Ces informations peuvent ensuite être mappées vers les champs de votre propre base ou de votre logiciel métier.
Comment intégrer une API carte grise dans son application ?
1. Nettoyer la plaque saisie
Avant d'effectuer la requête, normalisez la plaque :
- suppression des espaces ;
- suppression des tirets si nécessaire ;
- conversion en majuscules.
Exemple :
fh-034-dd → FH034DD
2. Effectuer l'appel côté serveur
La clé API ne doit pas être exposée dans le navigateur. L'appel doit idéalement être effectué depuis votre back-end : PHP, Laravel, Node.js, Python, Java, C# ou toute autre technologie capable de consommer une API REST.
3. Traiter les champs comme facultatifs
Ne supposez jamais qu'un champ sera présent pour tous les véhicules.
Votre code doit gérer proprement :
- une plaque non trouvée ;
- une donnée manquante ;
- une erreur HTTP ;
- une erreur réseau ;
- une limite de quota atteinte.
4. Conserver une saisie manuelle de secours
Même avec une API, une application professionnelle doit permettre à l'utilisateur de compléter ou corriger les champs lorsque cela est nécessaire.
5. Mettre en cache lorsque c'est pertinent
Si votre application consulte plusieurs fois la même plaque, enregistrer les données récupérées peut réduire les appels identiques.
Le cache peut être géré dans une base de données, Redis ou tout autre système adapté à votre architecture.
API carte grise, VIN et identification véhicule
La plaque constitue un excellent point d'entrée, mais le VIN reste un identifiant technique très utile dans de nombreux processus automobiles.
Lorsque le VIN est disponible dans la réponse, vous pouvez l'utiliser comme donnée complémentaire dans votre système.
Si votre besoin principal est précisément de récupérer le VIN à partir d'une plaque, consultez notre guide : retrouver le VIN avec une plaque d'immatriculation.
API carte grise pour garages et centres auto
Un garage peut utiliser ce type d'API pour créer automatiquement une fiche atelier à partir de la plaque du client.
Le réceptionnaire saisit la plaque, puis le logiciel récupère les caractéristiques disponibles afin de préremplir la fiche véhicule.
Nous détaillons ce cas d'usage dans l'article API plaque d'immatriculation pour garage.
API carte grise pour assurance automobile
Un assureur ou un comparateur peut également utiliser la plaque comme première étape d'un devis automobile.
Le formulaire peut préremplir une partie des caractéristiques du véhicule avant de demander au prospect de confirmer les informations.
Pour ce cas d'usage, consultez notre article API plaque d'immatriculation pour assurance.
API carte grise pour pièces détachées et e-commerce
Dans le domaine des pièces automobiles, identifier précisément le véhicule permet de préparer la recherche de compatibilité dans un catalogue.
L'API peut fournir des informations comme la version, le code moteur ou certaines références techniques lorsqu'elles sont disponibles.
Notre article API plaque d'immatriculation pour pièces auto détaille cette logique.
FAQ sur les API carte grise
Une API carte grise fournit-elle une carte grise officielle ?
Non. L'API fournit des données véhicule structurées à partir de la plaque d'immatriculation. Elle ne délivre pas de certificat d'immatriculation officiel et ne remplace pas une démarche administrative.
Peut-on récupérer les informations d'un véhicule uniquement avec la plaque ?
Oui, lorsqu'un véhicule est disponible dans la source utilisée. Les données retournées peuvent inclure la marque, le modèle, la version, le VIN, le carburant, la puissance, la date de mise en circulation et d'autres caractéristiques techniques.
Peut-on récupérer le VIN avec l'API ?
Le VIN peut faire partie des données retournées lorsqu'il est disponible pour le véhicule interrogé. Votre code doit toujours vérifier sa présence avant de l'utiliser.
L'API fonctionne-t-elle avec Laravel ou PHP ?
Oui. Une application Laravel ou PHP peut envoyer une requête HTTP vers l'endpoint GET /fr, transmettre le paramètre plaque et traiter la réponse JSON côté serveur.
Où consulter les endpoints disponibles ?
Vous pouvez consulter la page APIs et la documentation technique de api-plaque.com pour voir l'endpoint, les paramètres requis et le format de réponse.
Conclusion
Une API carte grise permet de simplifier l'identification d'un véhicule en utilisant une donnée que l'utilisateur connaît immédiatement : sa plaque d'immatriculation.
Pour un garage, un assureur, une plateforme de carte grise, un site de pièces auto ou une application de flotte, cette approche permet de préremplir les formulaires, de réduire les erreurs de saisie et de structurer plus facilement les données véhicule.
Pour commencer, découvrez l'API Plaque Immatriculation France, consultez sa documentation, puis testez une première requête avec votre propre intégration.