API SRA France

Documentation officielle · API automobile

API SRA France

Identifiez une référence de véhicule français grâce à son code SRA et obtenez les caractéristiques techniques au format JSON : marque, modèle, version, motorisation, puissance, CO₂ et plus encore.

REST APIJSONFrance (FR)Méthode GET

Présentation de l’API SRA

Notre API SRA permet la recherche d’une référence automobile française à partir d’un code SRA. Elle renvoie des données techniques structurées, adaptées à l’intégration dans les logiciels automobiles, outils d’assurance et systèmes de gestion de véhicules.

Assurance automobileGestion de flottesLogiciels métiersRéparation automobile

Endpoint de recherche

GET/sra

https://api.apiplaqueimmatriculation.com/sra

Exemple de requête

URL de recherche

https://api.apiplaqueimmatriculation.com/sra?code_sra=PE47122&token=VotreToken&pays=FR

Remplacez VotreToken par votre token personnel. Ne publiez jamais votre token réel dans un widget Elementor ou dans du JavaScript accessible aux visiteurs.

Paramètres de la requête

Paramètre	Type	Requis	Description
`code_sra`	string	Oui	Code SRA du véhicule, ex. `PE47122`.
`token`	string	Oui	Clé personnelle d’authentification.
`pays`	string	Oui	Code pays. Valeur prise en charge ici : `FR`.

Exemple de réponse JSON

Exemple fourni pour le code SRA PE47122 (Peugeot 208).

JSON · Exemple de réussite

{
  "data": {
    "erreur": "",
    "sra_id": "PE47122",
    "pays": "FR",
    "marque": "PEUGEOT",
    "modele": "208",
    "sra_commercial": "1.2 PURE TECH 82 ALLURE",
    "version": "1.2 VTI 82",
    "date1erCir_fr": "24-02-2017",
    "puisFisc": "4",
    "energie": "4",
    "energieNGC": "ESSENCE",
    "genreVCG": "1",
    "genreVCGNGC": "VP",
    "co2": "104",
    "nb_portes": 5,
    "nbr_passagers": null,
    "poids": 975,
    "cylindres": 3,
    "ccm": 1199,
    "puisFiscReelKW": "60",
    "puisFiscReelCH": 82,
    "code_boite_vitesse": null,
    "boite_vitesse": "M",
    "carrosserieCG": "CI",
    "cnit": null,
    "logo_marque": "https://api.apiplaqueimmatriculation.com/public/storage/photos_marques/88.png?v=1",
    "photo_modele": "https://api.apiplaqueimmatriculation.com/public/storage/photos_modeles/33807.jpg"
  },
  "api_version": "*",
  "message": "",
  "code_erreur": 200
}

Description des données

Champ	Description
`sra_id`	Code SRA recherché
`pays`	Code pays
`marque`, `modele`	Constructeur et modèle
`sra_commercial`	Désignation commerciale SRA
`version`	Version ou motorisation
`date1erCir_fr`	Date au format JJ-MM-AAAA
`puisFisc`	Puissance fiscale en CV
`energie`, `energieNGC`	Code énergie et libellé du carburant
`genreVCG`, `genreVCGNGC`	Code et libellé du genre du véhicule
`co2`	Émissions de CO₂ en g/km
`nb_portes`, `nbr_passagers`	Nombre de portes et de passagers
`poids`	Poids en kg
`cylindres`, `ccm`	Nombre de cylindres et cylindrée en cm³
`puisFiscReelKW`, `puisFiscReelCH`	Puissance réelle en kW et en chevaux
`code_boite_vitesse`, `boite_vitesse`	Code et type de boîte (ex. M : manuelle)
`carrosserieCG`	Code carrosserie
`cnit`	Code national d’identification du type
`logo_marque`, `photo_modele`	URL du logo et de la photo du modèle
`data.erreur`, `message`	Messages d’erreur et d’information
`code_erreur`, `api_version`	Code de résultat et version d’API

Certains champs peuvent être null ou vides. Le code SRA décrit une référence de véhicule, pas nécessairement un véhicule individuel précis.

Exemples d’intégration

Choisissez votre langage et copiez le code pour intégrer l’API côté serveur.

PHP / Laravel HTTP Client

use Illuminate\Support\Facades\Http;

$response = Http::timeout(30)->get(
    'https://api.apiplaqueimmatriculation.com/sra',
    [
        'code_sra' => 'PE47122',
        'token' => env('API_PLAQUE_TOKEN'),
        'pays' => 'FR',
    ]
);

$response->throw();
$result = $response->json();

if (($result['code_erreur'] ?? null) === 200) {
    $vehicule = $result['data'];
    echo $vehicule['marque'] . ' ' . $vehicule['modele'];
}

JavaScript · Node.js (serveur)

const params = new URLSearchParams({
  code_sra: 'PE47122',
  token: process.env.API_PLAQUE_TOKEN,
  pays: 'FR'
});

const response = await fetch(
  `https://api.apiplaqueimmatriculation.com/sra?${params}`
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);

const result = await response.json();
if (result.code_erreur === 200) {
  console.log(result.data.marque, result.data.modele);
}

Python · requests

import os
import requests

response = requests.get(
    'https://api.apiplaqueimmatriculation.com/sra',
    params={
        'code_sra': 'PE47122',
        'token': os.environ['API_PLAQUE_TOKEN'],
        'pays': 'FR'
    },
    timeout=30
)
response.raise_for_status()
result = response.json()

if result.get('code_erreur') == 200:
    print(result['data']['marque'], result['data']['modele'])

Terminal · cURL

curl --get 'https://api.apiplaqueimmatriculation.com/sra' \
  --data-urlencode 'code_sra=PE47122' \
  --data-urlencode 'token=VotreToken' \
  --data-urlencode 'pays=FR' \
  --header 'Accept: application/json'

Gestion des erreurs & bonnes pratiques

Vérifiez le statut HTTP, puis le champ code_erreur dans la réponse JSON. En cas d’échec, utilisez les champs message et data.erreur pour afficher un message approprié.

Prévoyez aussi les cas de token invalide, de code SRA introuvable, d’indisponibilité du service et de données incomplètes.

À confirmer avant publication : les codes HTTP et formats exacts des réponses d’erreur n’ont pas été fournis. Le code 200 affiché dans les exemples correspond à une recherche réussie.

API SRA France

API SRA France

Présentation de l’API SRA

Endpoint de recherche

Exemple de requête

Paramètres de la requête

Exemple de réponse JSON

Description des données

Exemples d’intégration

Gestion des erreurs & bonnes pratiques

Nos APIS

Liens utiles

Paiement

Bénéficier de -20% pour le pack annuel