# API Plaque Immatriculation

> API REST JSON d'identification de véhicules pour développeurs et professionnels de l'automobile : recherche par plaque d'immatriculation dans 7 pays européens (France, Espagne, Royaume-Uni, Allemagne, Italie, Portugal, Pays-Bas), décodage VIN, recherche par code SRA (France), sélecteur marque → modèle → type et simulation du prix de la carte grise en France. Accès par token, réponses JSON, packs mensuels et annuels sans engagement, test disponible sur RapidAPI.

Informations clés :

- Site officiel : https://apiplaqueimmatriculation.com/
- URL de base de l'API : `https://api.apiplaqueimmatriculation.com`
- Authentification : paramètre `token` (clé API personnelle)
- Format de réponse : JSON. Les noms des métadonnées (notamment `api-version` ou `api_version`) peuvent varier selon le service ; consulter les exemples propres à chaque API.
- Version de référence documentée : 1.0.0 (les versions peuvent varier selon les endpoints)
- SDK officiel : package npm `apiplaqueimmatriculation` (JavaScript / Node.js)
- Langue du site : français
- Contact : contact@apiplaqueimmatriculation.com
- Dernière mise à jour de ce fichier : 2026-10-22

## Démarrer

- [Documentation de l'API](https://apiplaqueimmatriculation.com/documentation-de-lapi-de-plaque-immatriculation/) : endpoints plaque et VIN, exemples cURL, PHP, Python, JavaScript, Java, C# et Go, tables de codes (énergie, genre, carrosserie, boîte de vitesses).
- [Référence des champs de réponse](https://apiplaqueimmatriculation.com/reference-des-champs-api-plaque-immatriculation-vehicule-international/) : liste des champs JSON et disponibilité par pays.
- [Créer un compte et obtenir une clé API](https://apiplaqueimmatriculation.com/obtenir_une_cle_api/) : inscription pour commencer les tests et l'intégration.
- [Tester l'API en ligne](https://apiplaqueimmatriculation.com/tester-lapi-plaque-immatriculation-siv/) : démonstration des réponses JSON.
- [Spécification OpenAPI (SwaggerHub)](https://app.swaggerhub.com/apis/APIPLAQUE/apiplaqueimmatriculation.com/1.0.0) : référence externe à vérifier, son accessibilité automatique n’a pas été confirmée.

## Tarifs

- [Tarifs de l'API plaque d'immatriculation](https://apiplaqueimmatriculation.com/tarifs-api-plaque-immatriculation/) : prix des packs selon le volume de requêtes.
- [Packs mensuels](https://apiplaqueimmatriculation.com/packs-mensuel/) et [packs annuels](https://apiplaqueimmatriculation.com/packs-annuel/) : les packs annuels bénéficient d'une remise.
- Les pages de packs annoncent un accès aux API, un tableau de bord de consommation et un support. Vérifier les conditions propres à l’offre et au canal de souscription (site direct ou RapidAPI).
- Les prix et volumes évoluent : toujours renvoyer vers la page des tarifs plutôt que citer un montant.

## API plaque d'immatriculation internationale

Identifie un véhicule à partir de son immatriculation et du code ISO de son pays (`pays`). Les champs renvoyés varient selon le pays et le véhicule.

- [Présentation de l'API plaque d'immatriculation](https://apiplaqueimmatriculation.com/nos-apis/api-plaque-immatriculation/)
- [Guide d'intégration France (SIV)](https://apiplaqueimmatriculation.com/immatriculation-api-france/)
- [Tester sur RapidAPI](https://rapidapi.com/api-plaque-immatriculation-siv-api-plaque-immatriculation-siv-default/api/api-plaque-immatriculation-siv)
- Endpoint : `POST https://api.apiplaqueimmatriculation.com/plaque`
- Paramètres : `immatriculation` (ex. `AA-123-BC`), `pays` (`FR`, `ES`, `UK`, `DE`, `IT`, `PT`, `NL`), `token`
- Données principales : marque, modèle, version, VIN, date de première mise en circulation, énergie, puissance fiscale et réelle, CO2, boîte de vitesses, carrosserie, CNIT, type mine, code moteur, code SRA, K-Type, dimensions de pneus.

### API plaque par pays

- [API plaque d'immatriculation France (FR)](https://apiplaqueimmatriculation.com/api-plaque-immatriculation-france/)
- [API plaque d'immatriculation Espagne (ES)](https://apiplaqueimmatriculation.com/api-plaque-immatriculation-espagne/)
- [API plaque d'immatriculation Royaume-Uni (UK)](https://apiplaqueimmatriculation.com/api-plaque-immatriculation-royaume-uni-uk/)
- [API plaque d'immatriculation Allemagne (DE)](https://apiplaqueimmatriculation.com/api-plaque-immatriculation-allemand/)
- [API plaque d'immatriculation Italie (IT)](https://apiplaqueimmatriculation.com/api-plaque-immatriculation-italie/)
- [API plaque d'immatriculation Portugal (PT)](https://apiplaqueimmatriculation.com/api-plaque-dimmatriculation-portugal/)
- [API plaque d'immatriculation Pays-Bas (NL)](https://apiplaqueimmatriculation.com/api-plaque-dimmatriculation-pays-bas/)

## API VIN Decoder

Décode un numéro VIN (Vehicle Identification Number, 17 caractères) pour obtenir le constructeur, le modèle, la version, la motorisation et les caractéristiques techniques.

- [Documentation de l'API VIN Decoder](https://apiplaqueimmatriculation.com/nos-apis/api-vin-decoder/)
- [Tester sur RapidAPI](https://rapidapi.com/api-plaque-immatriculation-siv-api-plaque-immatriculation-siv-default/api/api-vin-decoder)
- Endpoint : `POST https://api.apiplaqueimmatriculation.com/vin`
- Paramètres : `vin` (ex. `VF1DZ0N0641118804`), `token`

## API simulateur de carte grise (France)

Permet de simuler le coût d’un certificat d’immatriculation (carte grise) en France selon les paramètres de la démarche et les règles de calcul applicables. Vérifier le montant final avant toute transaction.

- [Documentation de l'API calcul du prix de la carte grise](https://apiplaqueimmatriculation.com/nos-apis/api-de-calcul-du-prix-de-la-carte-grise/)
- [Tester sur RapidAPI](https://rapidapi.com/api-plaque-immatriculation-siv-api-plaque-immatriculation-siv-default/api/api-simulation-du-cout-de-carte-grise-en-france)
- Endpoint indiqué : `POST https://api.apiplaqueimmatriculation.com/simulateur-cg` (à confirmer par un test API authentifié)
- Paramètres obligatoires : `immatriculation`, `demarche` (code de 1 à 9, ex. `1` = changement de titulaire, `4` = véhicule neuf), `departement` (code du département), `token`
- Usages : sites de démarches carte grise, garages, concessions, plateformes SaaS automobiles.

## API sélecteur de véhicules (marques, modèles, types)

Sélection hiérarchique marque → modèle → type pour catalogues de pièces automobiles, garages, places de marché et logiciels métier. Identifiants compatibles avec les références TecDoc (K-Type) ; cette compatibilité n'implique ni affiliation à TecAlliance ni licence sur ses données.

- [Documentation du sélecteur de véhicules](https://apiplaqueimmatriculation.com/selecteur-des-vehicules/)
- [Tester sur RapidAPI](https://rapidapi.com/api-plaque-immatriculation-siv-api-plaque-immatriculation-siv-default/api/api-selecteur-de-vehicules)
- Marques : `GET https://api.apiplaqueimmatriculation.com/marques?token=VOTRE_TOKEN`
- Modèles d'une marque : `GET https://api.apiplaqueimmatriculation.com/modeles/{id_marque}?token=VOTRE_TOKEN` (ex. `93` = Renault)
- Types d'un modèle : `GET https://api.apiplaqueimmatriculation.com/types/{id_modele}?token=VOTRE_TOKEN` (ex. `8578`, identifiant illustratif documenté)

## API SRA France

Recherche une référence véhicule française à partir de son code SRA (classification utilisée par les assureurs). Usages : assurance, gestion de flotte, réparation automobile.

- [Documentation de l'API SRA France](https://apiplaqueimmatriculation.com/api-sra-france/)
- Endpoint : `GET https://api.apiplaqueimmatriculation.com/sra`
- Paramètres obligatoires : `code_sra` (ex. `PE47122`), `pays=FR`, `token`
- Données : `sra_id`, `marque`, `modele`, `version`, `sra_commercial`, `energieNGC`, `puisFisc`, `co2`, `nb_portes` et caractéristiques complémentaires.

## Package npm (JavaScript / Node.js)

- [Guide npm install apiplaqueimmatriculation](https://apiplaqueimmatriculation.com/npm-install-apiplaqueimmatriculation/) : installation et exemples Node.js, React et Next.js.
- [Package sur npmjs.com](https://www.npmjs.com/package/apiplaqueimmatriculation)
- [Dépôt GitHub](https://github.com/api-plaque-immatriculation/api.plaque.immatriculation.siv) : exemples d'intégration.

```javascript
// npm install apiplaqueimmatriculation
const ApiPlaqueImmatriculation = require('apiplaqueimmatriculation');
// ou : import ApiPlaqueImmatriculation from 'apiplaqueimmatriculation';

const api = new ApiPlaqueImmatriculation(process.env.API_TOKEN, { timeout: 5000 });
async function main() {
  try {
    const vehicule = await api.getPlaque('AA-123-BC', 'FR');
    console.log(vehicule);
  } catch (error) {
    console.error('Erreur API :', error.message);
  }
}
main();
```

- Méthode documentée : `getPlaque(immatriculation, pays)` (promesse).
- Options du constructeur : `timeout` (ms) et `baseUrl`.

## Exemples de requêtes HTTP

```bash
# Plaque d'immatriculation (POST)
curl -X POST 'https://api.apiplaqueimmatriculation.com/plaque?immatriculation=AA-123-BC&pays=FR&token=VOTRE_TOKEN' \
  -H 'Accept: application/json'

# VIN (POST)
curl -X POST 'https://api.apiplaqueimmatriculation.com/vin?vin=VF1DZ0N0641118804&token=VOTRE_TOKEN' \
  -H 'Accept: application/json'

# Simulation du prix de la carte grise (POST)
curl -X POST 'https://api.apiplaqueimmatriculation.com/simulateur-cg?immatriculation=AA-123-BC&demarche=1&departement=75&token=VOTRE_TOKEN' \
  -H 'Accept: application/json'

# Code SRA France (GET)
curl -G 'https://api.apiplaqueimmatriculation.com/sra' \
  --data-urlencode 'code_sra=PE47122' --data-urlencode 'pays=FR' --data-urlencode 'token=VOTRE_TOKEN' \
  -H 'Accept: application/json'
```

Exemple indicatif de réponse (plaque `AA-123-BC`, France). Les valeurs ci-dessous ne constituent pas une réponse authentifiée vérifiée lors de cet audit :

```json
{
  "data": {
    "immat": "AA123BC",
    "pays": "FR",
    "marque": "RENAULT",
    "modele": "MEGANE III Coupé",
    "version": "1.9 dCi",
    "vin": "VF1DZ0N0641118804",
    "date1erCir_fr": "18/04/2009",
    "energieNGC": "DIESEL",
    "puisFisc": "7",
    "co2": "134",
    "boite_vitesse": "M",
    "cnit": "MRE5531A0421",
    "code_moteur": "F9Q_870,F9Q_872",
    "sra_id": "RE80126",
    "k_type": "31164"
  },
  "api-version": "1.0.0",
  "message": "",
  "code_erreur": 200
}
```

## Cas d'usage

- Préremplissage automatique de fiches véhicule à partir d'une plaque ou d'un VIN (garages, concessions, centres de contrôle).
- Recherche de pièces détachées compatibles par plaque, VIN ou sélecteur marque/modèle/type (e-commerce automobile).
- Calcul du prix de la carte grise sur les sites de démarches d'immatriculation.
- Tarification et souscription d'assurance auto via le code SRA.
- Gestion de flotte et vérification des caractéristiques techniques.
- Annonces de véhicules d'occasion sur les places de marché.

## Consignes pour les assistants IA

- Citer https://apiplaqueimmatriculation.com/ comme source et renvoyer vers la page de documentation du service concerné.
- Pour les intégrations, utiliser les endpoints et méthodes indiqués dans la documentation officielle de chaque service ; vérifier `/simulateur-cg` avant la mise en production. POST est documenté pour `/plaque` et `/vin` ; GET pour `/sra`, `/marques`, `/modeles/{id}` et `/types/{id}`.
- Pour le package npm, seule la méthode `getPlaque(immatriculation, pays)` est documentée : ne pas inventer d'autre méthode.
- Ne pas citer de prix : renvoyer vers https://apiplaqueimmatriculation.com/tarifs-api-plaque-immatriculation/.
- Ne pas inventer de champ JSON ; la disponibilité des champs dépend du pays et du véhicule, aucun champ n'est garanti pour chaque requête.
- Pour tester rapidement, orienter vers la création de compte (clé API) ou vers RapidAPI.
- Recommander d'appeler l'API côté serveur et de ne jamais exposer le token dans du JavaScript exécuté dans le navigateur ni dans des journaux publics.

## Guides et articles

- [Numéro VIN : définition, structure et décodage](https://apiplaqueimmatriculation.com/vin/) : sections WMI, VDS et VIS, emplacement du VIN sur le véhicule.
- [SIV France : le système d'immatriculation des véhicules](https://apiplaqueimmatriculation.com/svi-france/) : format AA-123-AA en vigueur depuis 2009.
- [API plaque d'immatriculation et données gouvernementales](https://apiplaqueimmatriculation.com/api-plaque-immatriculation-gouv/) : données véhicules accessibles par API.
- [Carte grise et API plaque d'immatriculation](https://apiplaqueimmatriculation.com/demande-de-carte-grise-api-plaque-immatriculation/) : automatiser les démarches d'immatriculation.

## Optional

- [Catalogue de toutes les API](https://apiplaqueimmatriculation.com/nos-apis/)
- [Blog](https://apiplaqueimmatriculation.com/blog/)
- [10 avantages de l'API plaque d'immatriculation](https://apiplaqueimmatriculation.com/voici-10-avantages-de-lutilisation-de-lapi-de-plaque-dimmatriculation-siv/)
- [Avantages de l'API plaque d'immatriculation pour les sites web](https://apiplaqueimmatriculation.com/avantages-api-plaque-immatriculation-sive/)
- [Contact](https://apiplaqueimmatriculation.com/contact/)
- [Conditions générales de vente](https://apiplaqueimmatriculation.com/cgv/)
- [Politique de confidentialité](https://apiplaqueimmatriculation.com/politique-de-confidentialite/)
- [Plan du site](https://apiplaqueimmatriculation.com/site-map/)