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

8

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

FirstRegistrationDate

8

A

First registration date of the vehicle in Belgium

LastRegistrationDate

8

A

Last registration date of the vehicle in Belgium

DeletionDate

8

A

Date when the vehicle was removed

Demolished Code

1

A

Vehicle demolished code:
0: demolished by a non-approved center
1: demolished by an approved center

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 P: Car-Pass OK Label

CarpassOK

100

A, V

Here you will find the URL of the CarpassOK label
This label will show an icon if the VIN + kilometre combination is a valid combination and so the vehicle has a CarpassOK label. In all other situations this will be a transparent image.

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

Menu