Retrieve current valuation and forecast data using a stored Brego Derivative ID, perfect for revaluing portfolios of vehicles.
For users with portfolios of vehicles this method allows additional valuations to be obtained at a lower cost (i.e. without the need for a VRM lookup), particularly useful for clients who need to revalue portfolios of vehicles on a regular basis.
Key Features
ID-based Lookup
Reduced cost lookup with no reliance on VRM
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
Portfolio Management
Ideal for revaluing large portfolios on a regular basis
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 current & 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/currentandfuturevaluationsfromid/v2/?brego_derivative_id=0a1bc3d4-ef56-789g-h10i-j111k21l3m14¤t_kms=10231&forecast_date=2025-12-10®istration_date=2021-05-12&kms_per_annum=8000
Example Sandbox Request
https://sandbox.oneautoapi.com/brego/ireland/currentandfuturevaluationsfromid/v2/?brego_derivative_id=0a1bc3d4-ef56-789g-h10i-j111k21l3m14¤t_kms=10231&forecast_date=2025-12-10®istration_date=2021-05-12&kms_per_annum=8000
Request Parameters
brego_derivative_id
mandatory, string, e.g. 0a1bc3d4-ef56-789g-h10i-j111k21l3m14
Brego Derivative ID
current_kms
mandatory, string, e.g. 10231
Current mileage of the vehicle in kms
forecast_date
mandatory, string, e.g. 2025-12-10
This is the date when the forecasted value is required
registration_date
mandatory, string, e.g. 2021-05-12
Date the vehicle was first registered in the UK
kms_per_annum
mandatory, string, e.g. 8000
Expected annual mileage in kms
Sample Response
{
"success": true,
"result": {
"valuations": [
{
"retail_low_valuation": 21595,
"retail_average_valuation": 22767,
"retail_high_valuation": 23814,
"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"
},
"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. 23814
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.
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