Discover3

Versions by plate

Request Information

URL	GET https://data.inventario.pro/discover3/versions-by-plate?number=1887GLD
Category	Discover3

Description

Fetch vechicle data plus possible vehicle versions.

Response codes:

200 - vehicleData plus versions
204 - The provider did not return a response
206 - vehicleData only, versions is empty
400 - Most probably the plat is not valid

VehicleData values:

Field	Type	Description
vin	string	Vehicle Identification Number
bodyType	string	Type of vehicle body style
co2EmissionMixedDriving	number	CO2 emissions in g/km for mixed driving
curbWeight	number	Vehicle weight without passengers/cargo in kg
domiciledProvince	string	Province where vehicle is registered
driveWheels	string	Drive wheel configuration
ecoSticker	string	Environmental classification sticker
engineCodes	array	List of engine identification codes
enginePowerHp	number	Engine power in horsepower
enginePowerKw	number	Engine power in kilowatts
engineSize	number	Engine displacement in cc
euBodyworkType	string	European classification of bodywork
euEmissionStandard	string	European emission standard classification
euTypeApprovalNumber	string	European type approval certification number
euVehicleCategory	string	European vehicle category classification
firstRegistrationDate	string	Date of first vehicle registration
firstRegistrationDateInCountry	string	Date of first registration in current country
firstRegistrationYear	number	Year of first registration
fiscalPowerInSpain	number	Fiscal horsepower rating in Spain
fuel	string	Fuel type
gearbox	string	Transmission type
grossVehicleWeight	number	Maximum permitted weight in kg
ineMunicipalityVehCode	string	Municipal code for vehicle registration
lastOwnerChangeDate	string	Date of last ownership transfer
legalOwners	number	Number of legal owners
locationMunicipality	string	Municipality and province location
make	string	Vehicle manufacturer
maxPayload	number	Maximum cargo weight in kg
model	string	Vehicle model name
modelFamily	string	Vehicle model family
modelGeneration	string	Specific generation of the model
numberOfCylinders	number	Number of engine cylinders
numberOfDoors	number	Number of vehicle doors
numberOfPassengers	number	Maximum number of passengers
numberOfSeats	number	Total number of seats
ownerType	string	Type of vehicle owner
postalCode	string	Postal code of registration
registrationClassCode	string	Vehicle registration class code
registrationLocation	string	Location of vehicle registration
rentACar	string	Indicates if vehicle is for rent
renting	string	Indicates if vehicle is under renting contract
useType	string	Type of vehicle usage
variant	string	Specific vehicle variant code
vehicleDescription	string	Full vehicle description

The versions is an array of version, defined as:

Field	Type	Description
vehicle_id	string	Unique identifier for the vehicle version
version	string	Vehicle version name and specifications
year	string	Manufacturing year of the version
photo	string	URL to the vehicle version image
body_style	string	Type of vehicle body style
from_date	string	Start date of version availability
to_date	string	End date of version availability

A 400 status response will contain a message shaped as:

Field	Type	Description
message_id	string	Unique identifier for the error message
value	string	Detailed error message with external request ID

Header

Example responses

200 - Versions by plate

Response Code:

200 OK

Response Body:

{
    "jsonapi": {
        "version": "1.0"
    },
    "data": {
        "vehicleData": {
            "vin": "WVWZZZ9NZ9Y170474",
            "bodyType": "Compacto",
            "co2EmissionMixedDriving": 138,
            "curbWeight": 1014,
            "domiciledProvince": "Barcelona",
            "driveWheels": "Delantera",
            "ecoSticker": "Category C",
            "engineCodes": [
                "BBM"
            ],
            "enginePowerHp": 60,
            "enginePowerKw": 44,
            "engineSize": 1198,
            "euBodyworkType": "AB Hatchback",
            "euEmissionStandard": "Euro 4",
            "euTypeApprovalNumber": "e1*2001\/116*0174",
            "euVehicleCategory": "M1",
            "firstRegistrationDate": "2009-03-03",
            "firstRegistrationDateInCountry": "2009-03-03",
            "firstRegistrationYear": 2009,
            "fiscalPowerInSpain": 8.72,
            "fuel": "Gasolina",
            "gearbox": "Manual",
            "grossVehicleWeight": 1570,
            "ineMunicipalityVehCode": "08019",
            "lastOwnerChangeDate": "2017-12-22",
            "legalOwners": 2,
            "locationMunicipality": "Barcelona, Barcelona",
            "make": "VOLKSWAGEN",
            "maxPayload": 556,
            "model": "Polo",
            "modelFamily": "Polo",
            "modelGeneration": "Polo VIII",
            "numberOfCylinders": 3,
            "numberOfDoors": 4,
            "numberOfPassengers": 4,
            "numberOfSeats": 5,
            "ownerType": "persona f\u00edsica",
            "postalCode": "08023",
            "registrationClassCode": "1",
            "registrationLocation": "Barcelona, ES",
            "rentACar": "No",
            "renting": "N",
            "useType": "Privado",
            "variant": "ABSBBMX01-FM5FM52T0891",
            "vehicleDescription": "VOLKSWAGEN Polo VIII 1.2 i"
        },
        "versions": [
            {
                "vehicle_id": "sa3N3YWdlbjpwb2xvOjIwMDk6My1wdWVydGFzOmFkdmFuY2U6cG9sby0zcC0xMi02MC1jdnZlOmMYXI6dm9",
                "version": "Polo 3p Advance 1.2 60 CV",
                "year": "2009",
                "photo": "https:\/\/www.km77.com\/media\/fotos\/volkswagen_polo_2009_3295_1_peq.jpg",
                "body_style": "Turismo",
                "from_date": "2012-02-01",
                "to_date": "2012-09-01"
            },
            {
                "vehicle_id": "sa3N3YWdlbjpwb2xvOjIwMDk6My1wdWVydGFzOmFkdmFuY2U6cG9sby0zcC1hZHZhbmNlLTEyLTYwLWN2dmU6YwYXI6dm9",
                "version": "Polo 3p Advance 1.2 60 CV",
                "year": "2009",
                "photo": "https:\/\/www.km77.com\/media\/fotos\/volkswagen_polo_2009_3295_1_peq.jpg",
                "body_style": "Turismo",
                "from_date": "2012-09-01",
                "to_date": "2014-03-01"
            },
            {
                "vehicle_id": "sa3N3YWdlbjpwb2xvOjIwMDk6NS1wdWVydGFzOmFkdmFuY2U6cG9sby01cC0xMi02MC1jdjJ2ZTpjYXI6dm9",
                "version": "Polo 5p Advance 1.2 60 CV",
                "year": "2009",
                "photo": "https:\/\/www.km77.com\/media\/fotos\/volkswagen_polo_2009_3105_1_peq.jpg",
                "body_style": "Turismo",
                "from_date": "2012-02-01",
                "to_date": "2012-09-01"
            },
            {
                "vehicle_id": "sa3N3YWdlbjpwb2xvOjIwMDk6NS1wdWVydGFzOmFkdmFuY2U6cG9sby01cC1hZHZhbmNlLTEyLTYwLWN2dmU6YwYXI6dm9",
                "version": "Polo 5p Advance 1.2 60 CV",
                "year": "2009",
                "photo": "https:\/\/www.km77.com\/media\/fotos\/volkswagen_polo_2009_3105_1_peq.jpg",
                "body_style": "Turismo",
                "from_date": "2012-09-01",
                "to_date": "2014-03-01"
            },
            {
                "vehicle_id": "sa3N3YWdlbjpwb2xvOjIwMDU6My1wdWVydGFzOmVkaXRpb246cG9sby0zcC1lZGl0aW9uLTEyLTYwLWN2dmU6YwYXI6dm9",
                "version": "Polo 3p Edition 1.2 60 CV",
                "year": "2005",
                "photo": "https:\/\/www.km77.com\/media\/fotos\/volkswagen_polo_2005_1854_1_peq.jpg",
                "body_style": "Turismo",
                "from_date": "2007-06-01",
                "to_date": "2008-01-01"
            },
            {
                "vehicle_id": "sa3N3YWdlbjpwb2xvOjIwMDU6My1wdWVydGFzOnVuaXRlZDpwb2xvLTNwLXVuaXRlZC0xMi02MC1jdnZlOmMYXI6dm9",
                "version": "Polo 3p United 1.2 60 CV",
                "year": "2005",
                "photo": "https:\/\/www.km77.com\/media\/fotos\/volkswagen_polo_2005_1854_1_peq.jpg",
                "body_style": "Turismo",
                "from_date": "2008-01-01",
                "to_date": "2009-04-01"
            },
            {
                "vehicle_id": "sa3N3YWdlbjpwb2xvOjIwMDU6NS1wdWVydGFzOmVkaXRpb246cG9sby01cC1lZGl0aW9uLTEyLTYwLWN2dmU6YwYXI6dm9",
                "version": "Polo 5p Edition 1.2 60 CV",
                "year": "2005",
                "photo": "https:\/\/www.km77.com\/media\/fotos\/volkswagen_polo_2005_1856_1_peq.jpg",
                "body_style": "Turismo",
                "from_date": "2007-06-01",
                "to_date": "2008-01-01"
            },
            {
                "vehicle_id": "sa3N3YWdlbjpwb2xvOjIwMDU6NS1wdWVydGFzOnVuaXRlZDpwb2xvLTVwLXVuaXRlZC0xMi02MC1jdnZlOmMYXI6dm9",
                "version": "Polo 5p United 1.2 60 CV",
                "year": "2005",
                "photo": "https:\/\/www.km77.com\/media\/fotos\/volkswagen_polo_2005_1856_1_peq.jpg",
                "body_style": "Turismo",
                "from_date": "2008-01-01",
                "to_date": "2009-07-01"
            }
        ]
    },
    "meta": {
        "timestamp": "2025-02-26T09:43:20+00:00",
        "hash": "d1fe7d57cf455f45306145d5e6878c3c3b72c614"
    }
}

206 - Versions by plate

Response Code:

206 Partial content

Response Body:

{
    "jsonapi": {
        "version": "1.0"
    },
    "data": {
        "vehicleData": {
            "vin": "KLAJF696EWK043658",
            "curbWeight": 1153,
            "dateOfDeregistration": "2016-06-10",
            "driveWheels": "Delantera",
            "engineCodes": [
                "A16DMS"
            ],
            "engineSize": 1598,
            "euEmissionStandard": "Euro 2",
            "euVehicleCategory": "M1",
            "firstRegistrationDate": "1997-10-30",
            "firstRegistrationDateInCountry": "1997-10-30",
            "firstRegistrationYear": 1997,
            "fiscalPowerInSpain": 11.63,
            "fuel": "Gasolina",
            "gearbox": "Manual",
            "lastOwnerChangeDate": "1997-10-30",
            "legalOwners": 5,
            "make": "DAEWOO",
            "model": "NUBIRA",
            "modelFamily": "Nubira",
            "modelGeneration": "Nubira 1 (J100)",
            "numberOfCylinders": 4,
            "numberOfDoors": 4,
            "numberOfPassengers": 4,
            "numberOfSeats": 5,
            "permanentDeregistration": "true",
            "registrationClassCode": "0",
            "registrationLocation": "Barcelona, ES",
            "rentACar": "No",
            "renting": "N",
            "useType": "Privado",
            "vehicleDescription": "DAEWOO Nubira 1 (J100) 1.6 i"
        },
        "versions": []
    },
    "meta": {
        "timestamp": "2025-02-26T10:07:48+00:00",
        "hash": "12cab8792f844d7473e775be9d91fc0e071ff469"
    }
}

400 - Versions by plate

Response Code:

400 Bad request

Response Body:

{
    "jsonapi": {
        "version": "1.0"
    },
    "data": {
        "message": {
            "message_id": "EA054",
            "value": "The VIN or License Plate provided is invalid. Please check the VINReg argument and try again. Request ID: 4e0a4944-ce59-4c47-b4e1-139ec178acd6"
        }
    },
    "meta": {
        "timestamp": "2025-02-26T10:16:31+00:00",
        "hash": "9481dc8ed6d079c9e8e2a511c8c4547ddb2aa6ea"
    }
}