Brego uses advanced modelling and artificial intelligence to produce accurate current and forecast valuation data on used vehicles.
In addition to the current valuation, the service provides a series of monthly forecast values based on user defined mileage and end date, making it suitable for a wide range of forecast and risk management use cases.
Key Features
VIN-based Lookup
Easily identify vehicle by vehicle identification number
Current Valuation
Highly accurate based on whole-market research
Forecast Valuation
AI-based forecast, with unmatched coverage
PCP & Lease Agreements
Set future values for new and used lease and PCP agreements with confidence
Portfolio Management
Ideal for revaluing portfolios of vehicles
Predictive Equity
Predict future equity and risk exposure with a monthly time-series of forecast values
Sample Response
V2
Documentation
Introduction
This endpoint returns high, average and low, retail and trade forecast valuations.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/brego/ireland/currentandfuturevaluationsfromvin/v2/?vehicle_identification_number=abcde1234f56789101¤t_kms=10231&kms_per_annum=8000&forecast_date=2025-12-20
Example Sandbox Request
https://sandbox.oneautoapi.com/brego/ireland/currentandfuturevaluationsfromvin/v2/?vehicle_identification_number=abcde1234f56789101¤t_kms=10231&kms_per_annum=8000&forecast_date=2025-12-20
Request Parameters
vehicle_identification_number
mandatory, string, e.g. abcde1234f56789101
Vehicle identification (VIN) number
current_kms
mandatory, string, e.g. 10231
Current mileage of the vehicle in kms
kms_per_annum
mandatory, string, e.g. 8000
The expected annual mileage in kms
forecast_date
mandatory, string, e.g. 2025-12-20
This is the date when the forecasted value is required.
Sample Response
{
"success": true,
"result": {
"valuations": [
{
"retail_low_valuation": 21595,
"retail_average_valuation": 22767,
"retail_high_valuation": 22814,
"trade_low_valuation": 16351,
"trade_average_valuation": 17239,
"trade_high_valuation": 18032,
"current_mileage": 80000,
"version": "2024-05-01"
}
],
"brego_derivative_id": "0a1bc3d4-ef56-789g-h10i-j111k21l3m14",
"vehicle_identification_number": "abcde123fg5678910",
"currency_unit": "eur",
"mileage_unit": "km",
"vehicle_desc": "Mini Cooper S",
"vehicle_type": "car"
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
retail_low_valuation
e.g. 21595
The suggested retail low valuation including VAT for the specified vehicle.
retail_average_valuation
e.g. 22767
The suggested retail average valuation including VAT for the specified vehicle.
retail_high_valuation
e.g. 22814
The suggested retail high valuation including VAT for the specified vehicle .
trade_low_valuation
e.g. 16351
The suggested trade low valuation including VAT for the specified vehicle.
trade_average_valuation
e.g. 17239
The suggested trade average valuation including VAT for the specified vehicle.
trade_high_valuation
e.g. 18032
The suggested trade high valuation including VAT for the specified vehicle.
current_mileage
e.g. 80000
Current mileage of the vehicle
version
e.g. 2024-05-01
Date point of the valuation
brego_derivative_id
e.g. 0a1bc3d4-ef56-789g-h10i-j111k21l3m14
The Brego Derivative ID.
vehicle_identification_number
e.g. abcde123fg5678910
Vehicle identification number (VIN).
currency_unit
e.g. eur
The currency unit.
mileage_unit
e.g. km
The mileage unit.
vehicle_desc
e.g. Mini Cooper S
The Vehicle description
vehicle_type
e.g. car
Class of vehicle.
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