Endpoints

Système d'Identification des Véhicules (SIV)

Cette fonction permet de récupérer les données informatives statiques d'un véhicule à partir de sa plaque d'immatriculation ou de son code VIN (Vehicle Identification Number).

GET /v1/siv/fr/{plate_or_vin}
x-carmoove-token: <token>
Content-type: application/json

Paramètres

Champ	Type	Description
plate_or_vin	String	Plaque d'immatriculation ou code VIN du véhicule.

Réponse

Champ	Type	Description
certificate	Object	Données contenues dans la carte grise.
additional_information	Object	Données complémentaires.
fluids	Object	Données concernant les fluides.
electric	Object	Données concernant les véhicules électriques.
tires	Array	Données concernant les montes de pneus.
error	String	Code d'erreur. Peut être manquant en cas de requête réussie.

Exemple de réponse (extrait) :

{
  "certificate": {
    "plate": "AB123CD",
    "brand": "Renault",
    "model": "Clio",
    "VIN": "VF1XXXXXXXXXXXXXX"
  },
  "additional_information": {
    "color": "Gris",
    "bodywork": "Berline"
  },
  "fluids": {
    "fuel_tank_capacity": 45
  },
  "electric": {},
  "tires": [
    { "front_display": "195/55R16", "rear_display": "195/55R16" }
  ]
}

Sauf mention contraire, tous les champs peuvent être vides (String) ou à 0 (Number) en cas de manque d'information.

Objet certificate

Cet objet contient les informations que l'on peut trouver sur une carte grise, un certificat d'immatriculation ou tout autre document d'identification d'un véhicule fourni par une autorité étatique compétente.

Nom du champ	Type	Description	Champ carte grise
plate	String	Immatriculation du véhicule	A
first_registration	String	Date de première immatriculation	B
brand	String	Marque du véhicule	D.1
type_variant_version	String	Type, version ou variante du modèle de voiture	D.2
cnit	String	Code national d'identification du type	D.2.1
model	String	Dénomination commerciale	D.3
vin	String	N° d'identification du véhicule / VIN	E
mass_f1	Number	Masse en charge maximale techniquement admissible	F.1
mass_f2	Number	Masse en charge maximale techniquement admissible, sauf pour les motocycles (en kg)	F.2
mass_f3	Number	Masse en charge maximale admissible de l'ensemble en service dans l'État membre d'immatriculation (en kg)	F.3
mass_g	Number	Masse du véhicule en service avec carrosserie et dispositif d'attelage en cas de véhicule tracteur de catégorie autre que M1 (en kg)	G
unloaded_weight	Number	Poids à vide national	G.1
category	String	Catégorie du véhicule	J
national_type	String	Genre national	J.1
national_bodywork	String	Carrosserie - désignation nationale	J.3
reception_number	String	N° de réception par type	K
displacement	Number	Cylindrée en cm3	P.1
max_net_power	Number	Puissance nette maximale (en kW)	P.2
energy	String	Type de carburant ou source d'énergie	P.3
administrative_power	Number	Puissance administrative nationale	P.6
power_mass_ratio	Number	Rapport puissance/masse en kW/kg (uniquement pour les motocycles)	Q
seats	Number	Nombre de places assises, y compris celle du conducteur	S.1
standing_places	Number	Nombre de places debout	S.2
sound_level	Number	Niveau sonore à l'arrêt (en dB [A])	U.1
engine_speed	Number	Vitesse du moteur (en min-1)	U.2
co2	Number	CO2 (en g/km)	V.7
environmental_class	String	Indication de la classe environnementale de réception CE	V.9
certificate_date	String	Date du certificat d'immatriculation	I

Objet additional_information

Cet objet contient des informations complémentaires au certificat d'immatriculation du véhicule.

Nom du champ	Type	Description
color	String	Couleur du véhicule
model	String	Nom du modèle
generation	String	Génération du modèle
additional_model	String	Donnée complémentaire sur le nom du modèle
full_version	String	Version complète
version	String	Version
cylinders_in_liters	Number	Cylindrées (en litres)
injection_label	String	Injection
injection_type	String	Type d'injection
valves	Number	Nombre de valves
horsepower	Number	Puissance (en chevaux)
bodywork	String	Carrosserie
commercial_start_date	String	Date de début de commercialisation
commercial_end_date	String	Date de fin de commercialisation
phase	String	Phase de commercialisation
doors	Number	Nombre de portes
engine_code	String	Code moteur
transmission_type	String	Type de transmission
euro_standard	String	Standard Euro
particulate_filter	Bool	Présence d'un filtre à particules
adblue	Bool	Adblue
gearbox_code	String	Code boite de vitesse
gearbox_type	String	Type de boite de vitesse
gears	Number	Nombre de rapports de vitesse
crit_air	String	Vignette Crit'Air (en France uniquement)
urban_co2	Number	CO2 en mode urbain (en g/km)
extra_urban_co2	Number	CO2 en mode extra-urbain (en g/km)
urban_fuel_consumption	Number	Consommation urbaine
extra_urban_fuel_consumption	Number	Consommation extra-urbaine
combined_fuel_consumption	Number	Consommation combinée
starter_battery_power	Number	Puissance de la batterie de démarrage
starter_battery_capacity	Number	Capacité de la batterie de démarrage
rear_braking_system	String	Système de freinage arrière
rear_trunk_capacity	Number	Capacité du coffre arrière (en litres)
extended_rear_trunk_capacity	Number	Capacité étendue du coffre arrière (en litres)
max_length	Number	Longueur maximale
combined_horse_power	Number	Puissance combinée
wheel_drive	String	Roues motrices
front_axle_type	String	Type de suspensions avant
rear_axle_type	String	Type de suspensions arrières

Objet fluids

Cet objet contient les données concernant les fluides des différents organes du véhicule.

Nom du champ	Type	Description
fuel_tank_capacity	Number	Capacité du réservoir de carburant
engine_oil_standard	String	Norme d'huile moteur
engine_oil_acea	String	Norme ACEA
engine_oil_viscosity	String	Viscosité de l'huile moteur
engine_oil_with_filter_capacity_min	Number	Capacité minimale d'huile moteur
engine_oil_with_filter_capacity_max	Number	Capacité maximale d'huile moteur
brake_fluid_capacity	Number	Capacité de liquide de frein
brake_fluid_standard	String	Norme de liquide de frein
engine_coolant_capacity_min	Number	Capacité minimale de liquide de refroidissement
engine_coolant_capacity_max	Number	Capacité maximale de liquide de refroidissement
engine_coolant_type	String	Type de liquide de refroidissement
air_conditioning_gas_capacity_min	Number	Capacité minimale de gaz d'air conditionné
air_conditioning_gas_capacity_max	Number	Capacité maximale de gaz d'air conditionné
air_conditioning_gas_standard	String	Norme de gaz d'air conditionné
power_steering_fluid_capacity	Number	Capacité de liquide de direction assistée
power_steering_fluid_standard	String	Norme de liquide de direction assistée

Objet electric

Cet objet contient des données complémentaires concernant les véhicules électriques.

Nom du champ	Type	Description
front_engine_type	String	Type de moteur avant
front_engine_kw_power	Number	Puissance du moteur avant (en kW)
front_engine_horsepower	Number	Puissance du moteur avant (en chevaux)
1st_rear_engine_type	String	Type du 1er moteur arrière
1st_rear_engine_kw_power	Number	Puissance du 1er moteur arrière (en kW)
1st_rear_engine_horsepower	Number	Puissance du 1er moteur arrière (en chevaux)
2nd_rear_engine_type	String	Type du 2nd moteur arrière
2nd_rear_engine_kw_power	Number	Puissance du 2nd moteur arrière (en kW)
2nd_rear_engine_horsepower	Number	Puissance du 2nd moteur arrière (en chevaux)
combined_kw_power	Number	Puissance combinée
engine_cooling_type	String	Type de refroidissement moteur
front_engine_nm_torque	Number	Couple du moteur avant
1st_rear_engine_nm_torque	Number	Couple du 1er moteur arrière
2nd_rear_engine_nm_torque	Number	Couple du 2nd moteur arrière
combined_nm_torque	Number	Couple combiné
battery_weight	Number	Poids de la batterie
battery_layout	String	Position de la batterie
battery_type	String	Type de batterie
battery_voltage	Number	Voltage de la batterie
battery_kw_power	Number	Puissance de la batterie
1st_battery_kwh_capacity	Number	Capacité de la 1ère batterie
usable_1st_battery_kwh_capacity	Number	Capacité utile de la 1ère batterie
2nd_battery_kwh_capacity	Number	Capacité de la 2nde batterie
usable_2nd_battery_kwh_capacity	Number	Capacité utile de la 2nde batterie
charging_plug	String	Prise de recharge
dc_charger_power_kw	Number	Puissance du chargeur DC
dc_charging_time_min	Number	Temps minimum de recharge DC
ac_charger_power_kw	Number	Puissance du chargeur AC
ac_charging_time_80_home_min	Number	Temps de recharge à 80 % (en minutes)
ac_charging_time_80_home_reinforced_min	Number	Temps de recharge renforcée à 80 % (en minutes)
ac_charging_time_80_wallbox_min	Number	Temps de recharge à une borne à 80 % (en minutes)
acceleration_0_100	Number	Temps de 0 à 100 km/h
max_speed	Number	Vitesse maximale
wltp_combined_autonomy_summer	Number	Autonomie en été (conduite mixte)
wltp_combined_autonomy_winter	Number	Autonomie en hiver (conduite mixte)
wltp_urban_autonomy_summer	Number	Autonomie en été (conduite urbaine)
wltp_urban_autonomy_winter	Number	Autonomie en hiver (conduite urbaine)
wltp_highway_autonomy_summer	Number	Autonomie en été (conduite sur autoroute)
wltp_highway_autonomy_winter	Number	Autonomie en hiver (conduite sur autoroute)
combined_consumption_kwh_100km_summer	Number	Consommation aux 100 km en été (conduite mixte)
combined_consumption_kwh_100km_winter	Number	Consommation aux 100 km en hiver (conduite mixte)
urban_consumption_kwh_100km_summer	Number	Consommation aux 100 km en été (conduite urbaine)
urban_consumption_kwh_100km_winter	Number	Consommation aux 100 km en hiver (conduite urbaine)
highway_consumption_kwh_100km_summer	Number	Consommation aux 100 km en été (conduite sur autoroute)
highway_consumption_kwh_100km_winter	Number	Consommation aux 100 km en hiver (conduite sur autoroute)

Objet tires

Cet objet (Array) contient des données concernant les montes de pneus. Chaque élément documente les pneus avant et arrière.

Nom du champ	Type	Description
front_display	String	Référence pneu avant
front_width	Number	Largeur du pneu avant
front_ratio	Number	Rapport hauteur/largeur du pneu avant
front_radial	Number	Diamètre de la jante du pneu avant
front_load	Number	Indice de charge du pneu avant
front_speed	String	Indice de vitesse du pneu avant
front_normal_pressure	Number	Pression recommandée du pneu avant
front_highway_pressure	Number	Pression sur autoroute recommandée du pneu avant
front_is_summer	Bool	Pneu avant été
front_is_winter	Bool	Pneu avant hiver
front_is_all_season	Bool	Pneu avant 4 saisons
rear_display	String	Référence pneu arrière
rear_width	Number	Largeur du pneu arrière
rear_ratio	Number	Rapport hauteur/largeur du pneu arrière
rear_radial	Number	Diamètre de la jante du pneu arrière
rear_load	Number	Indice de charge du pneu arrière
rear_speed	String	Indice de vitesse du pneu arrière
rear_normal_pressure	Number	Pression recommandée du pneu arrière
rear_highway_pressure	Number	Pression sur autoroute recommandée du pneu arrière
rear_is_summer	Bool	Pneu arrière été
rear_is_winter	Bool	Pneu arrière hiver
rear_is_all_season	Bool	Pneu arrière 4 saisons