Brego uses advanced modelling and artificial intelligence to produce some of the most accurate vehicle valuations in the automotive industry.
Valuations are updated daily and provide a spread of retail and trade values that provide retailers, lenders and remarketing operations with additional insight into the market.
Key Features
VIN-based Lookup
Easily identify vehicle by vehicle identification number
Current Valuation
Highly accurate based on whole-market research
Unmatched Coverage
Value cars, commercials, motorcycles, motorhomes, caravans and more with a single endpoint
Low, Average & High Valuations
6 valuations for retail and trade provides the ability to value for specification and condition
Updated Daily
For maximum accuracy in todays dynamic used vehicle market
1.2bn+ Data Points
Unique depth of data and coverage of asset types
Sample Response
V2
Documentation
Introduction
This endpoint returns mileage adjusted high, average and low condition categories for retail and trade 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/valuationfromvin?vehicle_identification_number=ABCDE123456F78910¤t_mileage=10231&valuation_date=2024-05-01
Example Sandbox Request
https://sandbox.oneautoapi.com/brego/valuationfromvin?vehicle_identification_number=ABCDE123456F78910¤t_mileage=10231&valuation_date=2024-05-01
Request Parameters
vehicle_identification_number
mandatory, string, e.g. ABCDE123456F78910
Vehicle identification number
current_mileage
mandatory, string, e.g. 10231
The current mileage of the vehicle in full
valuation_date
optional, string, e.g. 2024-05-01
Allows the user to specify the date for the current/initial valuation (e.g. a historic date)
Sample Response
{
"success": true,
"result": {
"retail_low_valuation": 22131,
"retail_average_valuation": 23876,
"retail_high_valuation": 25751,
"trade_low_valuation": 19254,
"trade_average_valuation": 20772,
"trade_high_valuation": 22403,
"current_mileage": 20000,
"vehicle_desc": "Mini Cooper S",
"brego_derivative_id": "0a1bc3d4-ef56-789g-h10i-j111k21l3m14",
"vehicle_identification_number": "ABCDE123456F78910",
"currency_unit": "gbp",
"mileage_unit": "mi",
"version": "2020-01-01"
},
"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. 22131
The suggested retail low valuation including VAT for the specified vehicle.
retail_average_valuation
e.g. 23876
The suggested retail average valuation including VAT for the specified vehicle.
retail_high_valuation
e.g. 25751
The suggested retail high valuation including VAT for the specified vehicle .
trade_low_valuation
e.g. 19254
The suggested trade low valuation including VAT for the specified vehicle.
trade_average_valuation
e.g. 20772
The suggested trade average valuation including VAT for the specified vehicle.
trade_high_valuation
e.g. 22403
The suggested trade high valuation including VAT for the specified vehicle.
current_mileage
e.g. 20000
Current mileage of the vehicle
vehicle_desc
e.g. Mini Cooper S
The Vehicle description
brego_derivative_id
e.g. 0a1bc3d4-ef56-789g-h10i-j111k21l3m14
The Brego Derivative ID.
vehicle_identification_number
e.g. ABCDE123456F78910
Vehicle identification number (VIN).
currency_unit
e.g. gbp
The currency unit.
mileage_unit
e.g. mi
The mileage unit.
version
e.g. 2020-01-01
Date point of the valuation
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