Endpoints

Vehicle Registration System (SIV)

This function retrieves the static informational data of a vehicle from its license plate or VIN (Vehicle Identification Number).

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

Parameters

Field	Type	Description
plate_or_vin	String	Vehicle's license plate or VIN code.

Response

Field	Type	Description
certificate	Object	Data contained in the registration certificate.
additional_information	Object	Additional information.
fluids	Object	Fluid-related data.
electric	Object	Electric vehicle data.
tires	Array	Tire fitment data.
error	String	Error code. May be absent on a successful request.

Example response (excerpt):

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

Unless stated otherwise, all fields may be empty (String) or 0 (Number) when information is missing.

certificate object

This object contains the information found on a registration certificate or any other vehicle identification document issued by a competent state authority.

Field name	Type	Description	Certificate field
plate	String	Vehicle registration plate	A
first_registration	String	Date of first registration	B
brand	String	Vehicle make	D.1
type_variant_version	String	Type, variant or version of the car model	D.2
cnit	String	National type identification code	D.2.1
model	String	Commercial name	D.3
vin	String	Vehicle identification number / VIN	E
mass_f1	Number	Maximum technically permissible laden mass	F.1
mass_f2	Number	Maximum technically permissible laden mass, except for motorcycles (in kg)	F.2
mass_f3	Number	Maximum permissible laden mass of the combination in service in the member state of registration (in kg)	F.3
mass_g	Number	Mass of the vehicle in service with bodywork and coupling device for a towing vehicle of a category other than M1 (in kg)	G
unloaded_weight	Number	National unladen weight	G.1
category	String	Vehicle category	J
national_type	String	National type	J.1
national_bodywork	String	Bodywork - national designation	J.3
reception_number	String	Type approval number	K
displacement	Number	Displacement in cm3	P.1
max_net_power	Number	Maximum net power (in kW)	P.2
energy	String	Fuel type or energy source	P.3
administrative_power	Number	National administrative power	P.6
power_mass_ratio	Number	Power-to-mass ratio in kW/kg (motorcycles only)	Q
seats	Number	Number of seating positions, including the driver's	S.1
standing_places	Number	Number of standing places	S.2
sound_level	Number	Stationary sound level (in dB [A])	U.1
engine_speed	Number	Engine speed (in min-1)	U.2
co2	Number	CO2 (in g/km)	V.7
environmental_class	String	EC type-approval environmental class	V.9
certificate_date	String	Registration certificate date	I

additional_information object

This object contains information supplementing the vehicle's registration certificate.

Field name	Type	Description
color	String	Vehicle color
model	String	Model name
generation	String	Model generation
additional_model	String	Additional data on the model name
full_version	String	Full version
version	String	Version
cylinders_in_liters	Number	Displacement (in liters)
injection_label	String	Injection
injection_type	String	Injection type
valves	Number	Number of valves
horsepower	Number	Power (in horsepower)
bodywork	String	Bodywork
commercial_start_date	String	Commercial launch date
commercial_end_date	String	Commercial end date
phase	String	Commercial phase
doors	Number	Number of doors
engine_code	String	Engine code
transmission_type	String	Transmission type
euro_standard	String	Euro standard
particulate_filter	Bool	Presence of a particulate filter
adblue	Bool	Adblue
gearbox_code	String	Gearbox code
gearbox_type	String	Gearbox type
gears	Number	Number of gears
crit_air	String	Crit'Air sticker (France only)
urban_co2	Number	Urban-cycle CO2 (in g/km)
extra_urban_co2	Number	Extra-urban-cycle CO2 (in g/km)
urban_fuel_consumption	Number	Urban fuel consumption
extra_urban_fuel_consumption	Number	Extra-urban fuel consumption
combined_fuel_consumption	Number	Combined fuel consumption
starter_battery_power	Number	Starter battery power
starter_battery_capacity	Number	Starter battery capacity
rear_braking_system	String	Rear braking system
rear_trunk_capacity	Number	Rear trunk capacity (in liters)
extended_rear_trunk_capacity	Number	Extended rear trunk capacity (in liters)
max_length	Number	Maximum length
combined_horse_power	Number	Combined power
wheel_drive	String	Drive wheels
front_axle_type	String	Front suspension type
rear_axle_type	String	Rear suspension type

fluids object

This object contains data about the fluids in the vehicle's various components.

Field name	Type	Description
fuel_tank_capacity	Number	Fuel tank capacity
engine_oil_standard	String	Engine oil standard
engine_oil_acea	String	ACEA standard
engine_oil_viscosity	String	Engine oil viscosity
engine_oil_with_filter_capacity_min	Number	Minimum engine oil capacity
engine_oil_with_filter_capacity_max	Number	Maximum engine oil capacity
brake_fluid_capacity	Number	Brake fluid capacity
brake_fluid_standard	String	Brake fluid standard
engine_coolant_capacity_min	Number	Minimum coolant capacity
engine_coolant_capacity_max	Number	Maximum coolant capacity
engine_coolant_type	String	Coolant type
air_conditioning_gas_capacity_min	Number	Minimum air conditioning gas capacity
air_conditioning_gas_capacity_max	Number	Maximum air conditioning gas capacity
air_conditioning_gas_standard	String	Air conditioning gas standard
power_steering_fluid_capacity	Number	Power steering fluid capacity
power_steering_fluid_standard	String	Power steering fluid standard

electric object

This object contains additional data concerning electric vehicles.

Field name	Type	Description
front_engine_type	String	Front engine type
front_engine_kw_power	Number	Front engine power (in kW)
front_engine_horsepower	Number	Front engine power (in horsepower)
1st_rear_engine_type	String	Type of the 1st rear engine
1st_rear_engine_kw_power	Number	Power of the 1st rear engine (in kW)
1st_rear_engine_horsepower	Number	Power of the 1st rear engine (in horsepower)
2nd_rear_engine_type	String	Type of the 2nd rear engine
2nd_rear_engine_kw_power	Number	Power of the 2nd rear engine (in kW)
2nd_rear_engine_horsepower	Number	Power of the 2nd rear engine (in horsepower)
combined_kw_power	Number	Combined power
engine_cooling_type	String	Engine cooling type
front_engine_nm_torque	Number	Front engine torque
1st_rear_engine_nm_torque	Number	Torque of the 1st rear engine
2nd_rear_engine_nm_torque	Number	Torque of the 2nd rear engine
combined_nm_torque	Number	Combined torque
battery_weight	Number	Battery weight
battery_layout	String	Battery position
battery_type	String	Battery type
battery_voltage	Number	Battery voltage
battery_kw_power	Number	Battery power
1st_battery_kwh_capacity	Number	Capacity of the 1st battery
usable_1st_battery_kwh_capacity	Number	Usable capacity of the 1st battery
2nd_battery_kwh_capacity	Number	Capacity of the 2nd battery
usable_2nd_battery_kwh_capacity	Number	Usable capacity of the 2nd battery
charging_plug	String	Charging plug
dc_charger_power_kw	Number	DC charger power
dc_charging_time_min	Number	Minimum DC charging time
ac_charger_power_kw	Number	AC charger power
ac_charging_time_80_home_min	Number	Time to charge to 80% (in minutes)
ac_charging_time_80_home_reinforced_min	Number	Reinforced time to charge to 80% (in minutes)
ac_charging_time_80_wallbox_min	Number	Time to charge to 80% at a charging station (in minutes)
acceleration_0_100	Number	0 to 100 km/h time
max_speed	Number	Maximum speed
wltp_combined_autonomy_summer	Number	Summer range (combined driving)
wltp_combined_autonomy_winter	Number	Winter range (combined driving)
wltp_urban_autonomy_summer	Number	Summer range (urban driving)
wltp_urban_autonomy_winter	Number	Winter range (urban driving)
wltp_highway_autonomy_summer	Number	Summer range (highway driving)
wltp_highway_autonomy_winter	Number	Winter range (highway driving)
combined_consumption_kwh_100km_summer	Number	Summer consumption per 100 km (combined driving)
combined_consumption_kwh_100km_winter	Number	Winter consumption per 100 km (combined driving)
urban_consumption_kwh_100km_summer	Number	Summer consumption per 100 km (urban driving)
urban_consumption_kwh_100km_winter	Number	Winter consumption per 100 km (urban driving)
highway_consumption_kwh_100km_summer	Number	Summer consumption per 100 km (highway driving)
highway_consumption_kwh_100km_winter	Number	Winter consumption per 100 km (highway driving)

tires object

This object (Array) contains data about tire fitments. Each element documents the front and rear tires.

Field name	Type	Description
front_display	String	Front tire reference
front_width	Number	Front tire width
front_ratio	Number	Front tire aspect ratio
front_radial	Number	Front tire rim diameter
front_load	Number	Front tire load index
front_speed	String	Front tire speed index
front_normal_pressure	Number	Front tire recommended pressure
front_highway_pressure	Number	Front tire recommended highway pressure
front_is_summer	Bool	Front summer tire
front_is_winter	Bool	Front winter tire
front_is_all_season	Bool	Front all-season tire
rear_display	String	Rear tire reference
rear_width	Number	Rear tire width
rear_ratio	Number	Rear tire aspect ratio
rear_radial	Number	Rear tire rim diameter
rear_load	Number	Rear tire load index
rear_speed	String	Rear tire speed index
rear_normal_pressure	Number	Rear tire recommended pressure
rear_highway_pressure	Number	Rear tire recommended highway pressure
rear_is_summer	Bool	Rear summer tire
rear_is_winter	Bool	Rear winter tire
rear_is_all_season	Bool	Rear all-season tire