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" } }