What is this REST service?
The Autoconnect LOOKUP REST service is a REST service to look up any Belgian vehicle data based on a VIN (vehicle inscription number) and get its full technical and commercial profile.
Questions?
Do not hesitate to contact us should you need any further information or a test API key.
Call us +32 (0)3 369 18 17 or send a message to servicedesk@inmotiv.be
Which data is available?
The available data is grouped in data blocks. Each data block is identified by a letter. Several data blocks can be requested in one API call, by writing them together in the request_list.
- S – Vehicle exists block
- B – Basic block
- T – Technical block
- X – Extended block
- E – Emission block
- A – Fiscal (tax) block
- R – Registration block
- C – Commercial block
- V – Current residual value
- F – Future residual value
Examples of the content of each block can be found further in this document. Please note that dependencies exist between blocks: some more advanced blocks cannot be accessed without other blocks in the same request.
How should the REST service be called?
One vehicle per call can be requested. The URL to look up a vehicle is built as follows:
https://api.inmotiv.be/rest/lookup/1.5/<API_key>/<vin>/<request_list>/<kmeters>/<versionID>
Please note that the <> signs should not be written in the real request.
The current version of the API is version 1.5. Previous versions that still can be accessed through the same URL, by modifying the version number, are 1.0, 1.1, 1.2, 1.3, 1.4. Previous versions contain less fields and blocks.
The response will be returned as an XML document which will contain the requested data blocks in <request_list>. If the request was not well formed or if the requested vehicle was not found, the service will return an error message. Apart from the S block, the request will not be payable in that case.
Optional parameters
The parameter “kmeters” (current kilometers of a vehicule) only needs to be provided when data blocks V or F are requested in “request_list”.
The parameter “versionID” is the versionID of a commercial version that can be found in the C block. This parameter is mandatory for the blocks A, V and F. This means that 2 consecutive requests are necessary for blocks A, V and F.
Authentication
For using the LOOKUP REST API service, just like any other Autoconnect API service, you need an API key, which is connected to an existing user in Autoconnect. This API key allows us to measure the service usage and charge per transaction.
The XML response of a request will be displayed in the language of the user. The descriptions are available in Dutch, French and German. If your application is using multiple languages, you will need multiple API keys, one for each user with a different language.
Besides this REST service, the same data is also available through our web-application, and by exchanging batch (csv/txt) files.
Example:
We will demonstrate and explain the response using an example of a request:
https://api.inmotiv.be/rest/lookup/1.4/<APIkey>/WAUZZZ4G5HN009507/BXERSTPCAVF/7705/15060259
In this example, the following components are:
- WAUZZZ4G5HN009507: the VIN number
- BXERSTPCAVF: the list of blocks
- 7705: the current number of kilometers of this vehicle
- 15060259: the versionID of the commercial version, coming from a former request of block C
This example request is done using a French speaking user’s API key and returns this XML
<VINdata
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Request>
<VIN>WAUZZZ4G5HN009507</VIN>
<RequestedBlocks>BXERSTPCAVF</RequestedBlocks>
<RequestId>53413792</RequestId>
<Language>NL</Language>
<MemberId>6</MemberId>
<MemberName>RDC inMotiv Belgium</MemberName>
</Request>
<Block
xsi:type="BlockB" name="Basic vehicle data" id="BlockB">
<MakeTypeDescr>AUDI</MakeTypeDescr>
<CommercialName>A6 AVANT</CommercialName>
<WVTA>e1*2007/46*0436*25</WVTA>
<Version>FD7FD7CK001P4G02S57MMEM2K0</Version>
<Variant>ADDDAF1</Variant>
<ColourCode>D</ColourCode>
<Colour>Grijs</Colour>
<FuelCode>02</FuelCode>
<FuelType>Diesel</FuelType>
</Block>
<Block
xsi:type="BlockX" name="Extended vehicle data" id="BlockX">
<Revision>0</Revision>
<Type>4G</Type>
<PvaBelgium/>
<BuildDate/>
<CategoryCode>M1</CategoryCode>
<Category>
VOERTUIGEN BESTEMD VOOR PERSONENVERVOER-TEN HOOGSTE 8 ZITPLAATSEN-BESTUURDER NIET MEEGEREKEND
</Category>
<BodyworkType>AC</BodyworkType>
<BodyworkTypeLabel>AC - STATIONWAGEN</BodyworkTypeLabel>
<KindCode>AC</KindCode>
<Kind>STATIONWAGEN</Kind>
<MakeDiv>0770</MakeDiv>
<TypeDiv>00024</TypeDiv>
<Buildup/>
<EuroNorm>6</EuroNorm>
<Status>Normaal</Status>
<StatusCode>NOR</StatusCode>
<AdministrativeStatus>Normaal</AdministrativeStatus>
<AdministrativeStatusCode>NOR</AdministrativeStatusCode>
<OffRoad/>
<Configuration/>
<TankContent>0</TankContent>
<TotalAxles>2</TotalAxles>
<PoweredAxles>0</PoweredAxles>
<NumberOfSeats>5</NumberOfSeats>
<NumberOfStandingPlaces>0</NumberOfStandingPlaces>
<NumberOfFrontPlaces>0</NumberOfFrontPlaces>
<NumberOfRearPlaces>0</NumberOfRearPlaces>
<NumberOfTotalPlaces>0</NumberOfTotalPlaces>
<Length>4943</Length>
<Width>1874</Width>
<Height>1421</Height>
<Tare>0</Tare>
<MassOnCoupling>0</MassOnCoupling>
<MassInRunningOrder>1800</MassInRunningOrder>
<MaxMassOnAxles>0</MaxMassOnAxles>
<MaxMassTrailerCombination>0</MaxMassTrailerCombination>
<TechnicPermissibleMass>2355</TechnicPermissibleMass>
<MmaNational>0</MmaNational>
<LoadWheelbaseRatio
xsi:nil="true"/>
<Suspension>Niet pneumatische ophanging</Suspension>
<ConnectMode/>
<TotalCylinderCapacity>1968</TotalCylinderCapacity>
<MaximumNetPowerRPM>0</MaximumNetPowerRPM>
<WeightPowerRatio>0</WeightPowerRatio>
<MaxNetPower>140</MaxNetPower>
<MaxSpeed>226</MaxSpeed>
<HandicCarFlag>false</HandicCarFlag>
<TachoFlag>false</TachoFlag>
<CustomsStickerCode>3</CustomsStickerCode>
<CounterType/>
</Block>
<Block
xsi:type="BlockE" name="Vehicle Emission data" id="BlockE">
<CoEngineTest>0.0000</CoEngineTest>
<NoxEngineTest>0.0000</NoxEngineTest>
<NmhcEngineTest>0.0000</NmhcEngineTest>
<ThcEngineTest>0.0000</ThcEngineTest>
<Ch4EngineTest>0.0</Ch4EngineTest>
<ParticulatesNumberEngineTest>0.0</ParticulatesNumberEngineTest>
<ParticulatesMassEngineTest>0.0</ParticulatesMassEngineTest>
<CoBenchTest>0.9300</CoBenchTest>
<NoxBenchTest>0.0550</NoxBenchTest>
<NmhcBenchTest>0.0000</NmhcBenchTest>
<HcBenchTest>0.0000</HcBenchTest>
<HcNoxBenchTest>0.0680</HcNoxBenchTest>
<SmokeCorrectCoeficientBenchTest>0.5</SmokeCorrectCoeficientBenchTest>
<ParticulatesNumberBenchTest>10.0</ParticulatesNumberBenchTest>
<ParticulatesMassBenchTest>0.0</ParticulatesMassBenchTest>
<Co2Combined>114</Co2Combined>
<Co2Urban>0</Co2Urban>
<Co2ExtraUrban>0</Co2ExtraUrban>
<FuelConsumptionCombined>4.4</FuelConsumptionCombined>
<FuelConsumptionUrban>4.9</FuelConsumptionUrban>
<FuelConsumptionExtraUrban>4.1</FuelConsumptionExtraUrban>
<SoundLevelStationary>68.0</SoundLevelStationary>
<SoundLevelDriveBy>70.0</SoundLevelDriveBy>
<MeasurementUnitEmission> </MeasurementUnitEmission>
</Block>
<Block
xsi:type="BlockR" name="Registration data" id="BlockR">
<PreRegistrationDate>22/06/2016</PreRegistrationDate>
<FirstRegistrationDate>11/08/2016</FirstRegistrationDate>
<LastRegistrationDate>11/10/2019</LastRegistrationDate>
<DeletionDate/>
<Demolished/>
<Completion>Het voertuig is compleet.</Completion>
<FiscalStatus>Fiscaal OK</FiscalStatus>
</Block>
<Block
xsi:type="BlockS" name="Precheck" id="BlockS">
<DataAvailable>Y</DataAvailable>
</Block>
<Block
xsi:type="BlockT" name="Technical control data" id="BlockT">
<TechnicalControlValidDate>04/10/2020</TechnicalControlValidDate>
<DistanceType>1</DistanceType>
<PreviousDistance>7705</PreviousDistance>
<CurrentDistance>91055</CurrentDistance>
</Block>
<Block
xsi:type="BlockC" name="Commercial data" id="BlockC">
<Version
version_id="15094409" score="108">
<modelName>A6 AVANT</modelName>
<VersionName>TDI Ultra S-Line Sport Edition S-Tronic</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">43863.63</VersionCatalogPrice>
</Version>
<Version
version_id="15088443" score="108">
<modelName>A6 AVANT</modelName>
<VersionName>TDI Ultra Sport Edition S-Tronic</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">42851.24</VersionCatalogPrice>
</Version>
<Version
version_id="15088440" score="108">
<modelName>A6 AVANT</modelName>
<VersionName>TDI Ultra Business Edition S-Tronic</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">43615.70</VersionCatalogPrice>
</Version>
<Version
version_id="15060259" score="108">
<modelName>A6 AVANT</modelName>
<VersionName>TDI Ultra S-Tronic</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">38760.33</VersionCatalogPrice>
</Version>
<Version
version_id="15060258" score="100">
<modelName>A6 AVANT</modelName>
<VersionName>TDI Ultra</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">36851.24</VersionCatalogPrice>
</Version>
<Version
version_id="15094397" score="90">
<modelName>A6 AVANT</modelName>
<VersionName>TDI S-Line Sport Edition Quattro S-Troni</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">46318.18</VersionCatalogPrice>
</Version>
<Version
version_id="15094396" score="90">
<modelName>A6 AVANT</modelName>
<VersionName>TDI Business Edition Quattro S-Tronic</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">46070.25</VersionCatalogPrice>
</Version>
<Version
version_id="15074347" score="90">
<modelName>A6 AVANT</modelName>
<VersionName>TDI Quattro S-Tronic</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">41214.88</VersionCatalogPrice>
</Version>
<Version
version_id="15053971" score="89">
<modelName>A6 AVANT</modelName>
<VersionName>TDI S-Line S-TRONIC ultra</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">40917.36</VersionCatalogPrice>
</Version>
<Version
version_id="15053970" score="89">
<modelName>A6 AVANT</modelName>
<VersionName>TDI S-TRONIC ultra</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">36752.07</VersionCatalogPrice>
</Version>
<Version
version_id="15053969" score="88">
<modelName>A6 AVANT</modelName>
<VersionName>TDI S-Line ultra</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">39016.53</VersionCatalogPrice>
</Version>
<Version
version_id="15053968" score="88">
<modelName>A6 AVANT</modelName>
<VersionName>TDI ultra</VersionName>
<VersionBodyworkType>Break</VersionBodyworkType>
<VersionCatalogPrice
unit="EUR" VAT="excl">34851.24</VersionCatalogPrice>
</Version>
</Block>
<Block
xsi:type="BlockA" name="Fiscal Data Block" id="BlockA">
<Disclaimer>
<NL>
De resultaten van de simulatie zijn louter informatief en hebben geen juridische bewijskracht. Onjuist gebruik van de toepassing of de invoer van verkeerde gegevens kunnen zorgen voor een resultaat dat verschilt van het bedrag op het aanslagbiljet.
</NL>
<FR>
Les résultats de cette simulation sont seulement à titre d'information et n'ont pas de valeur juridique. Une utilisation figuré de l'application ou l'introduction de données fautives peuvent mener à un résultat différent de celui calculé sur votre avertissement d'impot.
</FR>
<EN>
The results of the simulation are purely informative and have no evidentiary value. Improper use of the application or the input of wrong data may provide a result that is different from the amount on the tax bill.
</EN>
</Disclaimer>
<BenefitInKind>
<Amount>3096.24</Amount>
<Remarks/>
<Url>
http://financien.belgium.be/nl/particulieren/vervoer/bedrijfswagens
</Url>
</BenefitInKind>
<RoadTaxFlanders>
<Amount>492.57</Amount>
<Remarks/>
<Url>
https://belastingen.fenb.be/vfp-portal-pub2-web/simulatieVerkeersbelasting.html
</Url>
</RoadTaxFlanders>
<RoadTaxBrussels>
<Amount>421.74</Amount>
<Remarks/>
<Url>
http://www.belgium.be/nl/mobiliteit/Voertuigen/verkeersbelasting_en_verzekering/verkeersbelasting
</Url>
</RoadTaxBrussels>
<RoadTaxWalloon>
<Amount>429.40</Amount>
<Remarks/>
<Url> http://www.wallonie.be/fr/taxe-de-circulation</Url>
</RoadTaxWalloon>
<RegistrationTaxFlanders>
<Amount>505.16</Amount>
<Remarks/>
<Url>
https://belastingen.vlaanderen.be/BIV_tarief-niet-leasing-personenwagens%2C-auto-voor-dubbel-gebruik-en-minibussen
</Url>
</RegistrationTaxFlanders>
<RegistrationTaxBrussels>
<Amount>1734.60</Amount>
<Remarks/>
<Url>
http://financien.belgium.be/nl/particulieren/vervoer/inschrijving_en_belastingen/belasting_op_de_inverkeerstelling
</Url>
</RegistrationTaxBrussels>
<RegistrationTaxWalloon>
<Amount>1734.60</Amount>
<Remarks/>
<Url>
http://www.wallonie.be/fr/taxe-de-mise-en-circulation
</Url>
</RegistrationTaxWalloon>
<FiscalHorsePower>
<Amount>11.00</Amount>
<Remarks/>
<Url/>
</FiscalHorsePower>
<EcoScore>
<Amount>62.18</Amount>
<Remarks/>
<Url/>
</EcoScore>
</Block>
<Block
xsi:type="BlockV" name="Current residual values" id="BlockV">
<CurrentMileage>7705</CurrentMileage>
<CatalogPrice
unit="euro">43863</CatalogPrice>
<B2Bvalue unit="euro">22062</B2Bvalue>
<B2Cvalue unit="euro">28034</B2Cvalue>
<C2Cvalue unit="euro">27711</C2Cvalue>
<OpinionIndication>
B2B, B2C en C2C resultaten zijn inclusief, dan wel exclusief BTW, afhankelijk van de opgave van de Consumentenprijs, Opties & Accessoires.
</OpinionIndication>
</Block>
<Block
xsi:type="BlockF" name="Future residual values" id="BlockF">
<CurrentMileage>91055</CurrentMileage>
<Catalogprice
unit="euro">43863</Catalogprice>
<ContractDuration>48</ContractDuration>
<CurvePeriodicity>1</CurvePeriodicity>
<AnnualMileage>25000</AnnualMileage>
<B2Bvalue unit="euro">16015</B2Bvalue>
<B2Cvalue unit="euro">20349</B2Cvalue>
<C2Cvalue unit="euro">19419</C2Cvalue>
<EndB2Bvalue unit="euro">10809</EndB2Bvalue>
<EndB2Cvalue unit="euro">15487</EndB2Cvalue>
<EndC2Cvalue unit="euro">14341</EndC2Cvalue>
<EndMileage>107705</EndMileage>
<Periods>
<Period>
<EndDate>26-03-2020</EndDate>
<EndMileage>7705</EndMileage>
<EndB2Cvalue unit="euro">28034</EndB2Cvalue>
<EndB2Bvalue unit="euro">22062</EndB2Bvalue>
<EndC2Cvalue unit="euro">27711</EndC2Cvalue>
</Period>
<Period>
<EndDate>26-03-2021</EndDate>
<EndMileage>32705</EndMileage>
<EndB2Cvalue unit="euro">24169</EndB2Cvalue>
<EndB2Bvalue unit="euro">18459</EndB2Bvalue>
<EndC2Cvalue unit="euro">23504</EndC2Cvalue>
</Period>
<Period>
<EndDate>26-03-2022</EndDate>
<EndMileage>57705</EndMileage>
<EndB2Cvalue unit="euro">20838</EndB2Cvalue>
<EndB2Bvalue unit="euro">15444</EndB2Bvalue>
<EndC2Cvalue unit="euro">19936</EndC2Cvalue>
</Period>
<Period>
<EndDate>26-03-2023</EndDate>
<EndMileage>82705</EndMileage>
<EndB2Cvalue unit="euro">17965</EndB2Cvalue>
<EndB2Bvalue unit="euro">12921</EndB2Bvalue>
<EndC2Cvalue unit="euro">16910</EndC2Cvalue>
</Period>
<Period>
<EndDate>26-03-2024</EndDate>
<EndMileage>107705</EndMileage>
<EndB2Cvalue unit="euro">15487</EndB2Cvalue>
<EndB2Bvalue unit="euro">10809</EndB2Bvalue>
<EndC2Cvalue unit="euro">14341</EndC2Cvalue>
</Period>
</Periods>
<OpinionIndication>
B2B, B2C en C2C resultaten zijn inclusief, dan wel exclusief BTW, afhankelijk van de opgave van de Consumentenprijs, Opties & Accessoires.
</OpinionIndication>
</Block>
</VINdata>
The future residual values are based on default settings:
- Contract duration is 48 months
- Curve periodicity is 1 time per year
- The annual mileage is 25000 km/year
Autoconnect also provides a separate API for calculating current and future residual values, in which these parameters can be changed.
Explanation of data fields
Please find below a list of available data fields for each data set (block). We use the following abbreviations:
- A: Alphanumeric
- N: Numeric
- V: Variable Length (if not specified, the default value is fixed)
Data Set B: Basic Vehicle | |||
Name | Length | Type | Description |
MakeTypeDescr | 60 | A,V | Make name |
CommercialName | 20 | A,V | Model name |
WVTA | 40 | A,V | European Whole Vehicle Type Approval number and amendment |
Version | 35 | A,V | Version code, given by manufacturer |
Variant | 25 | A,V | Variant code, given by manufacturer |
ColourCode | 1 | A | Colour Code (see appendix for table) |
Colour | 30 | A,V | Colour Description. Only approximately 10 main colours can |
FuelCode | 2 | N | Fuel code (see appendix for table) |
FuelType | 30 | A,V | Fuel description as given by |
Data Set X: Extended Vehicle Data | |||
Name | Length | Type | Description |
Revision | 2 | N | Revision, given by manufacturer |
Type | 25 | A,V | Type, given by manufacturer |
PvaBelgium | 6 | A,V | Belgian homologation file number (PVA/PVG) |
BuildDate | 10 | A | Vehicle build date |
CategoryCode | 5 | A,V | European category code |
Category | 100 | A,V | European category description |
Bodyworktype | 2 | A | European bodywork type code, see appendix |
BodyworkTypeLabel | 100 | A,V | Bodywork type description |
KindCode | 2 | Vehicle kind code | |
Kind | 30 | A,V | Vehicle kind description |
MakeDiv | 4 | A,V | Make code as known by Belgian authorities |
TypeDiv | 5 | A,V | Model code as known by Belgian authorities |
Buildup | 2 | A | Code for build-up equipment, if applicable |
Euronorm | 3 | A | Euronorm (without the word “EURO”) |
Status | 30 | A,V | Description of the vehicle life cycle status |
StatusCode | 3 | A,V | Abbreviation for the vehicle life cycle |
LegalStatus | 30 | A,V | Description of the vehicle legal status |
LegalStatusCode | 3 | A,V | Abbreviation for the legal status code |
AdministrativeStatus | 30 | A,V | Description of the administrative status |
AdministrativeStatusCode | 3 | A,V | Abbreviation of the administrative status |
OffRoad | 1 | A | 'G' value if the vehicle is an 'off-road'; no values in other cases |
Configuration | 2 | A | Configuration (Pick-up,...) |
TankContent | 6 | N | Tank content in liter |
TotalAxles | 2 | N | Total number of axles |
NumberofSeats | 3 | N | Number of seats |
NumberofStandingPlaces | 3 | N | Number of standing places |
NumberofFrontPlaces | 2 | N | Number of front places |
NumberofRearPlaces | 2 | N | Number of rear places |
NumberofTotalPlaces | 3 | N | Total number of places |
Length | 6 | N | Vehicle length (in mm) |
Width | 6 | N | Vehicle width (in mm) |
Heigth | 6 | N | Vehicle height (in mm) |
Tare | 6 | N | Vehicle tare (in kg) |
MassOnCoupling | 6 | N | Maximum mass on coupling point (in kg) |
MassInRunningOrder | 6 | N | Mass in running order (in kg) |
MaxMassOnAxles | 6 | N | Maximum mass on axles (in kg) |
MaxMassTrailerCombination | 6 | N | Maximum mass of the trailer combination (in kg) |
TechnicPermissibleMass | 6 | N | Technical permissible maximum mass (in kg) |
MmaNational | 6 | N | National maximum mass (in kg) |
LoadWheelbaseRatio | 2 | A | Ratio Load to Wheelbase |
Suspension | 100 | A,V | Suspension Type |
ConnectMode | 50 | A,V | Type of connection for trailer |
TotalCylinderCapacity | 5 | N | Cylinder Capacity (cc) |
MaximumNetPowerRPM | 6 | N | Maximum power reached at rotations per minute |
WeightPowerRatio | 6 | N | Ratio Weight to Power |
MaxNetPower | 4 | N | Maximum vehicle power (kW). |
Max Speed | 6 | N | Maximum speed (km/h or miles/h) |
HandicCarFlag | 1 | A | Indication if the vehicle is adapted to disabled people |
TachoFlag | 1 | A | Indication if the vehicle has a tachograph |
EngineID | 15 | A | Manufacturer’s engine code |
CustomStickerCode | 1 | A,V | One digit, indicates the way the preregistration was handled at import |
CounterType | 1 | A | Number of digits on the odometer (5 or 6) |
Data Set E: Vehicle Emission Data | |||
Name | Length | Type | Description |
CoEngineTest | 5 | N | CO emission for engine test (mg/kWh) |
NoxEngineTest | 4 | N | NOX emission for engine test (mg/kWh) |
NmhcEngineTest | 4 | N | NMHC emission for engine test (mg/kWh) |
ThcEngineTest | 4 | N | THC emission for engine test (mg/kWh) |
Ch4EngineTest | 4 | N | CH4 emission for engine test (mg/kWh) |
ParticulatesNumberEngineTest | 4 | N | Number of particulates emission for engine test (10^8 particulates/km) |
ParticulatesMassEngineTest | 7 | N | Mass of particulates emission for engine test |
CoBenchTest | 5 | N | CO emission at bench test (engine and vehicle) (mg/km) |
NoxBenchTest | 4 | N | NOX emission at bench test (engine and vehicle) (mg/km) |
NhmcBenchTest | 4 | N | NMHC emission at bench test (engine and vehicle) (mg/km) |
HcBenchTest | 4 | N | HC emission at bench test (engine and vehicle) (mg/km) |
HcNoxBenchTest | 4 | N | HC+NOX emission at bench test (engine and vehicle) (mg/km) |
SmokeCorrectCoeficientBenchTest | 4 | N | Smoke correction coefficient at bench test (m-1) |
ParticulatesNumberBenchTest | 4 | N | Number of particulates emission at bench test (engine and vehicle)(10^8 particulates/km) |
ParticulatesMassBenchTest | 7 | N | Mass of particulates at bench test (engine and vehicle) |
Co2Combined | 4 | N | CO2 exhaust combined (gr/km) |
Co2Urban | 4 | N | CO2 exhaust urban (gr/km) |
Co2ExtraUrban | 4 | N | CO2 exhaust extra-urban (gr/km) |
FuelConsumptionCombined | 4 | N | Combined fuel consumption (cl/100km) |
FuelConsumptionUrban | 4 | N | Urban fuel consumption (cl/100km) |
FuelConsumptionExtraUrban | 4 | N | Extra urban fuel consumption (cl/100km) |
SoundLevelStationary | 4 | N | Sound level stationary (dB) |
SoundLevelDriveBy | 4 | N | Sound level drive by (dB) |
MeaurementUnitEmission | 1 | N | Unit of measuring the emission |
Data Set R: Registration Data | |||
Name | Length | Type | Description |
PreRegistrationDate | 10 | A | Date when the vehicle data was registered at the DIV |
FirstRegistrationDate | 10 | A | First registration date of the vehicle in Belgium |
LastRegistrationDate | 10 | A | Last registration date of the vehicle in Belgium |
DeletionDate | 10 | A | Date when the vehicle was removed |
Demolished Code | 1 | A | Vehicle demolished code: |
Completion | 100 | A, V | Is the vehicle complete or incomplete |
Data Set A: Fiscal data | ||||
BenefitInKind | Amount | 8,2 | N | Benefit in kind (VAA, ATN) |
Remarks | 300 | AN | ||
Url | 150 | AN | The URL points to the according government website for more information. | |
RoadTaxFlanders | Amount | 8,2 | N | Yearly road tax in Flanders |
Remarks | 300 | AN | ||
Url | 150 | AN | The URL points to the according government website for more information. | |
RoadTaxBrussels | Amount | 8,2 | N | Yearly road tax in Brussels |
Remarks | 300 | AN | ||
Url | 150 | AN | The URL points to the according government website for more information. | |
RoadTaxWalloon | Amount | 8,2 | N | Yearly road tax in Wallonia |
Remarks | 300 | AN | ||
Url | 150 | AN | The URL points to the according government website for more information. | |
RegistrationTaxFlanders | Amount | 8,2 | N | Registrationtax in Flanders |
Remarks | 300 | AN | ||
Url | 150 | AN | The URL points to the according government website for more information. | |
RegistrationTaxBrussels | Amount | 8,2 | N | Registrationtax in Brussels |
Remarks | 300 | AN | ||
Url | 150 | AN | The URL points to the according government website for more information. | |
RegistrationTaxWalloon | Amount | 8,2 | N | Registrationtax in Wallonia |
Remarks | 300 | AN | ||
Url | 150 | AN | The URL points to the according government website for more information. | |
FiscalHorsePower | Amount | 8,2 | N | Fiscal horsepower |
Remarks | 300 | AN | ||
Url | 150 | AN | The URL points to the according government website for more information. | |
EcoScore | Amount | 8,2 | N | Ecoscore (formulaby VITO) |
Remarks | 300 | AN | ||
Url | 150 | AN | The URL points to the according government website for more information. | |
Data Set T: Technical Control Data | |||
TechnicalControlValidDate | 8 | A | Validity for technical inspection (if the vehicle has passed technical inspection at least once) |
DistanceType | 1 | A | Odometer reading in km (K) or miles (M) |
CurrentDistance | 7 | N | Odometer reading at the last technical inspection. |
PreviousDistance | 7 | N | Odometer reading at the last but one technical inspection. |
Data Set C: Commercial Profiles | |||
Version_id | N | Version id of a corresponding commercial vehicle profile in AutoconnectCarwizard | |
Score | N | Probability that the commercial version is the right version for the technical vehicle profile. The higher the score, the more likely the version is the correct commercial profile. Commercial versions are ranked from high score to low score. | |
VersionName | A | Commercial name of the profile | |
VersionBodyworkType | A | AutoconnectCarwizard bodywork type description. This does not always match with the technical BodyWorkType in Data Set X. | |
VersionCatalogPrice | N | The historical catalogue price of the version (when the vehicle was a new vehicle on the market) | |
Data Set V: Current Residual Value Data | |||
CurrentMileage | 10 | N | Currentmileage |
CatalogPrice | 10 | N | Historical catalogue price of the version (when the vehicle was a new vehicle on the market) |
B2Bvalue | 10 | N | Current business to business residual value |
B2Cvalue | 10 | N | Current business to consumer value |
C2Cvalue | 10 | N | Current consumer to consumer value |
OpinionIndication | 300 | AN | Disclaimer |
Data Set F: Future Residual Value Data | |||
CurrentMileage | 10 | N | Currentmileage |
CatalogPrice | 10 | N | Historical catalogue price of the version (when the vehicle was a new vehicle on the market) |
ContractDuration | 10 | N | Contract / life time duration |
CurvePeriodity | 10 | N | How many interval points per year |
AnnualMileage | 10 | N | Annualmileage |
B2Bvalue | 10 | N | Current business to business value |
B2Cvalue | 10 | N | Current business to consumer value |
C2Cvalue | 10 | N | Current consumer to consumer value |
EndB2Bvalue | 10 | N | Future business to business end value |
EndB2Cvalue | 10 | N | Future business to consumer end value |
EndC2Cvalue | 10 | N | Future consumer to consumer end value |
EndMileage | 10 | N | Mileage at the end of the period |
Error handling
When an error occurs there will be only error nodes available under the element <VINdata>. The first one is <ErrorType> which is the codename for the error, and the second one is <ErrorDescription> which is a more detailed explanation of the error.
In the table below you will find the possible error codes:
| ErrorType | ErrorDescription |
|---|---|
| NOAUTH | Sorry, you do not have access to this service! |
| NOTFOUND | Sorry, this vehicle does not exist in our system. |
| INVALIDDATA | Sorry, this VIN is invalid. A VIN should never contain more than 17 characters and never contain the letter O. |
| COMERROR | Sorry, one or more data sources are unavailable at this moment. Please try again later or contact servicedesk@inmotiv.be |
Lookup tables
The following lookup tables display possible values for selected data elements.
Colour codes | Description (output will be determined by language of API, and is limited to only Dutch or French) |
A | Black |
B | Green |
C | White |
D | Grey |
E | Yellow |
F | Beige |
G | Red |
H | Brown |
I | Blue |
J | Orange |
K | Bordeaux |
X | Unknown |
Fueltype codes | Description (output will be determined by language of API, and is limited to only Dutch or French) |
01 | Petrol |
02 | Diesel |
03 | LPG (Liquefied Petroleum Gas) |
04 | Electricity |
05 | Other |
06 | CNG (Compressed Natural Gas) |
07 | Petrol + Elektricity |
08 | Diesel + Elektricity |
BodyWork Type | Description French | Description Dutch | Description German |
AA | BERLINE | SEDAN | STUFENHECKLIMOUSINE |
AB | VOITURE A HAYON ARRIERE | HATCHBACK | SCHRAGHECKLIMOUSINE |
AC | BREAK | STATIONWAGEN | KOMBILIMOUSINE |
AD | COUPE | COUPE | COUPE |
AE | CABRIOLET | CABRIOLET | KABRIOLIMOUSINE |
AF | VEHICULE A USAGES MULTIPLES | VOERTUIG MEERDERE DOELEINDEN | MEHRZWECKFAHRZEUG |
AR | REMORQUE NORMALE | AANHANGWAGEN | LASTANHANGER |
AZ | AMBULANCE | ZIEKENWAGEN | KRANKENWAGEN |
BC | AUTOBUS OU AUTOCAR | BUS OF CAR | LINIEN O. REISEBUS |
BF | VEHICULE SERVICE INCENDIE | BRANDWEERWAGEN | FEUERWEHRFAHRZEUG |
BP | VEHICULE LEGER BLINDE | LICHTE PANTSER | LEICHTER PANZERWAGEN |
BR | REMORQUE POUR BATEAUX | BOOTAANHANGWAGEN | BOOTSANHANGER |
CL | CORBILLARD | LIJKAUTO | LEICHENWAGEN |
CO | SEMI-REMORQUE CARAVANE | KAMPEEROPLEGGER | SATTELWOHNANHANGER |
CR | CARAVANE | KAMPEERAANHANGWAGEN | WOHNANHANGER |
CT | CAMIONNETTE | LICHTE VRACHTWAGEN | LEICHTER LASTKRAFTWAGEN |
CV | CAMION | VRACHTWAGEN | LASTKRAFTWAGEN |
DT | DEPANNEUSE | TAKELWAGEN | ABSCHLEPPWAGEN |
FA | VEHICULE A USAGES MULTIPLES | VOERTUIG MEERDERE DOELEINDEN | MEHRZWECKFAHRZEUG |
KG | VEHICULE GRUE | KRAANAUTO | KRANWAGEN |
LA | MATERIEL AGRICOLE | LANDBOUWMATERIEEL | LANDMASCHINEN |
LC | CAMION LENT | TRAGE VRACHTWAGEN | LANGSAMER LASTKRAFTWAGEN |
LS | VEHICULE LENT MIXTE | TRAGE DUBBEL GEBRUIK | LANGSAMER KOMBIWAGEN |
LT | CAMIONNETTE LENTE | TRAGE LICHTE VRACHTWAGEN | LANGSAMER KLEINLASTKRAFTWAGEN |
LV | VEHICULE LENT | TRAGE PERSONENAUTO | LANGSAMER PERSONENKRAFTWAGEN |
L1 | BROMFIETS | BROMFIETS | BROMFIETS |
L2 | BROMFIETS | BROMFIETS | BROMFIETS |
L3 | MOTOCYCLETTE | MOTORFIETS | KRAFTRAD |
L4 | MOTOCYCLETTE AVEC SIDECAR | MOTORFIETS MET SIDECAR | KRAFTRAD MIT BEIWAGEN |
L5 | TRICYCLE A MOTEUR | DRIEWIELER MET MOTOR | DREIRADRIGES KRAFTFAHRZEUG |
L6 | QUADRICYCLE A MOTEUR | VIERWIELER MET MOTOR | VIERRADRIGES KRAFTFAHRZEUG |
L7 | QUADRICYCLE A MOTEUR | VIERWIELER MET MOTOR | VIERRADRIGES KRAFTFAHRZEUG |
ML | MOTOCULTEUR | LANDBOUWMOTOR | EINACHSSCHLEPPER |
MM | MOISSONNEUSE | MAAIMACHINE | MAHMASCHINE |
MT | MATERIEL INDUSTRIEL | BEDRIJFSMATERIEEL | ARBEITSMASCHINEN |
M2 | MOTOCYCLETTE | MOTORFIETS | KRAFTRAD |
OA | SEMI-REMORQUE LENTE | TRAGE OPLEGGER | LANGSAMER SATTELANHANGER |
OM | MINIBUS | MINIBUS | KLEINBUS |
OR | REMORQUE OUTIL | WERKTUIGAANHANGWAGEN | GERATETRANSPORT-ANHANGER |
OS | SEMI-REMORQUE NORMALE | OPLEGGER | LASTSATTELANHANGER |
PR | REMORQUE POUR PLANEURS | ZWEEFVLIEGTUIGAANHANGWAGEN | SEGELFLUGZEUGANHANGER |
RL | REMORQUE LENTE | TRAGE AANHANGWAGEN | LANGSAMER ANHANGER |
SA | AUTOCARAVANE | KAMPEERWAGEN | WOHNMOBIL |
SB | VEHICULE BLINDE | GEPANTSERD VOERTUIG | BESCHUSSGESHUTZTES FAHRZEUG |
SC | AMBULANCE | ZIEKENWAGEN | KRANKENWAGEN |
SD | CORBILLARD | LIJKWAGEN | LEICHENWAGEN |
SF | VEHICULE SPECIALE | SPECIAAL VOERTUIG | VEHICULE SPECIALE |
SW | VOITURE MIXTE | AUTO DUBBEL GEBRUIK | KOMBIWAGEN |
TB | TROLLEYBUS | TROLLEYBUS | OBERLEITUNGSOMNIBUS |
TL | TRACTEUR AGRICOLE/SYLVICOLE | LANDBOUWTRACTOR | LAND/FORSTWIRTSCHAFTL.ZUGMASCH |
TP | ALL TYPES | ALL TYPES | ALL TYPES |
TR | TRACTEUR | TREKKER | STRASSENZUGMASCHINE |
TT | VEHICULE LENT (APRES TRANSF.) | TRAAG VOERTUIG (NA OMVORMING) | LANGSAMES FAHRZEUG |
VC | AUTOCARAVANE | KAMPEERAUTO | WOHNMOBIL |
VP | VOITURE | PERSONENAUTO | PERSONENKRAFTWAGEN |
CategoryCodes | Description |
Category M | used for the carriage of passengers |
Category M1 | no more than eight seats in addition to the driver seat (mainly, cars) |
Category M2 | more than eight seats in addition to the driver seat (buses) |
Category M3 | having a maximum mass not exceeding 5 tonnes (11,000 lb) |
Category N | having a maximum mass exceeding 5 tonnes |
Category N1 | used for the carriage of goods (trucks): |
Category N2 | having a maximum mass not exceeding 3.5 tonnes (7,700 lb) |
Category N3 | having a maximum mass exceeding 3.5 tonnes but not exceeding 12 tonnes (26,000 lb) |
Category O | having a maximum mass exceeding 12 tonnes |
Category O1 | trailers (including semi-trailers) |
Category O2 | maximum mass not exceeding 0.75 tonnes (1,700 lb) |
Category O3 | exceeding 0.75 tonnes but not exceeding 3.5 tonnes (7,700 lb) |
Category O4 | exceeding 3.5 tonnes but not exceeding 10 tonnes (22,000 lb) |
Category L | Motor vehicles with less than four wheels [but does include light four-wheelers] |
Category L1 | A two-wheeled vehicle with an engine cylinder capacity in the case of a thermic engine not exceeding 50 cm³ and whatever the means of propulsion a maximum design speed not exceeding 50 km/h. |
Category L2 | A three-wheeled vehicle of any wheel arrangement with an engine cylinder capacity in the case of a thermic engine not exceeding 50 cm³ and whatever the means of propulsion a maximum design speed not exceeding 50 km/h. |
Category L3 | A two-wheeled vehicle with an engine cylinder capacity in the case of a thermic engine exceeding 50 cm³ or whatever the means of propulsion a maximum design speed exceeding 50 km/h. |
Category L4 | A vehicle with three wheels asymmetrically arranged in relation to the longitudinal median plane with an engine cylinder capacity in the case of a thermic engine exceeding 50 cm³ or whatever the means of propulsion a maximum design speed exceeding 50 km/h (motor cycles with sidecars). |
Category L5 | A vehicle with three wheels symmetrically arranged in relation to the longitudinal median plane with an engine cylinder capacity in the case of a thermic engine exceeding 50 cm³ or whatever the means of propulsion a maximum design speed exceeding 50 km/h. |
Category L6 | A vehicle with four wheels whose unladen mass is not more than 350 kg, not including the mass of the batteries in case of electric vehicles, whose maximum design speed is not more than 45 km/h, and whose engine cylinder capacity does not exceed 50 cm³ for spark (positive) ignition engines, or whose maximum net power output does not exceed 4 kW in the case of other internal combustion engines, or whose maximum continuous rated power does not exceed 4 kW in the case of electric engines. |
Category L7 | A vehicle with four wheels, other than that classified for the category L6, whose unladen mass is not more than 450 kg[3] (650 kg[4] for vehicles intended for carrying goods), not including the mass of batteries in the case of electric vehicles and whose maximum continuous rated power does not exceed 15 kW. |
StatusCodes | Description |
DES | Destroyed |
REH | Repaired |
NOR | Normal |
ACC | Accident |
WHO | Without Homologation |
INC | Incomplete |
VAL | In validation procedure |
LegalStatusCodes | Description |
NOR | Normal |
STL | Stolen |
AdministrativeStatusCodes | Description |
EXP | Exported |
IMP | Imported |
NOR | Normal |
NIO | Not in Order |
FEX | Pending to be exported |