Manage the risks associated with older vehicles.
AutoPredict uses AI to analyse over 100 million data points and estimate remaining vehicle life based on age, mileage and MOT history, and this endpoint provides average statistics by brand and model range.
Used in association with VIN-level predictions this data provides additional context for decision makers.
Key Features
VRM Input
Enter a VRM for make and model analysis
Average Mileage
Discover the average final mileage of each make and model
Average Age
Learn how long each model is typically on the road
100m+ Data Points
Based on registration and MOT history data
Parc Analysis
Discover the number of currently registered and SORN vehicles of the same make and model
Risk Management Metric
Valuable data for portfolio management and residual values setting
Sample Response
V2
Documentation
Introduction
This endpoint provides manufacturer and model statistics to predict how long the vehicle is likely to remain on the road. This endpoint provides manufacturer and model statistics to predict how long the vehicle is likely to remain on the road.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/autopredict/statistics?vehicle_registration_mark=AB21ABC
Example Sandbox Request
https://sandbox.oneautoapi.com/autopredict/statistics?vehicle_registration_mark=AB21ABC
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number
Sample Response
{
"success": true,
"result": {
"vehicle_registration_mark": "AB21ABC",
"averages_data": {
"manufacturer_average_final_miles": 123456,
"model_average_final_miles": 123456,
"manufacturer_average_final_age": 12,
"model_average_final_age": 12
},
"number_left_data": {
"manufacturer_model_year_initially_registered": 12345,
"manufacturer_model_year_currently_licensed": 12345,
"manufacturer_model_year_currently_sorn": 123,
"manufacturer_model_year_percentage_left": 95
}
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
vehicle_registration_mark
e.g. AB21ABC
Vehicle registration number (VRM).
manufacturer_average_final_miles
e.g. 123456
The average number of final miles vehicles of this manufacturer complete.
model_average_final_miles
e.g. 123456
The average number of final miles vehicles of this model type completes.
manufacturer_average_final_age
e.g. 12
The average final age of vehicles of this manufacturer.
model_average_final_age
e.g. 12
The average final age of vehicles of this model.
manufacturer_model_year_initially_registered
e.g. 12345
The number of vehicles of this manufacturer and model year initially registered.
manufacturer_model_year_currently_licensed
e.g. 12345
The number of vehicles of this manufacturer and model year currently licenced.
manufacturer_model_year_currently_sorn
e.g. 123
The number of vehicles of this manufacturer and model year currently SORN.
manufacturer_model_year_percentage_left
e.g. 95
The percentage of vehicles of this manufacturer and model year that remain on the road.
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call
Status Codes
200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com