API endpoints
- https://api.bisnode.fi/vehicle/info/v2/vehiclepriceatspecifieddate/ - production environment
- https://api-test.bisnode.fi/vehicle/info/v2/vehiclepriceatspecifieddate/ - test environment
API request parameters
| Parameter | Description | |
|---|---|---|
| id | Vehicle registration number or VIN. | X |
| valuationDate | The future date when the price of the vehicle is estimated. | X |
| mileageToday | The vehicle's exact mileage today in kms if known. If not given, the price is evaluated using Bisnode's own data. | |
| mileageIncrease | The amount of kms the vehicle is driven between today and ValuationDate. If not specified, the mileage is predicted using Bisnode's vehicle specific model. | |
| X = Mandatory | ||
GET https://api-test.bisnode.fi/vehicle/info/v2/vehiclepriceatspecifieddate/{id}?valuationDate={valuationDate}&mileageToday={mileageToday}&mileageIncrease={mileageIncrease}
API response
| Element | Description |
|---|---|
| price | The current price of the vehicle in euros. |
| confidenceCodePrice | Confidence code of the price estimate. Values are between 1 and 5, where 1 describes the most accurate estimate and 5 the least accurate. |
| averageError | Average relative error of similar vehicles. Given as a fraction of the price, e.g. 0.1 = 10%. |
| confidenceCodeMileage | Confidence code of the mileage used in price estimateion. Values are between 1 and 5, where 1 describes the most accurate knowledge of the mileage and 5 the least accurate. Does not apply if mileageToday is given in the request parameters. |
| requestedParameters | The values of all parameters in the API request for debugging purposes. |
API request and response example
curl 'https://api-test.bisnode.fi/vehicle/info/v2/vehiclepriceatspecifieddate/IEI-289?valuationDate=2020-12-31&mileageToday=50000' -H 'x-api-key: 1234567890ABC'
Successful request and the API return results in JSON format.
{
"price": "4858.414965391171",
"confidenceCodePrice": 1,
"averageError": 0.1884615765343123,
"estimatedMileage": 50000,
"confidenceCodeMileage": 1,
"requestedParameters": {
"id": "IEI-289",
"mileageToday": "50000",
"valuationDate": "2020-12-31"
}
}