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/ireland/valuationfromvin?vehicle_identification_number=abcde1234f56789101¤t_kms=10231
Example Sandbox Request
https://sandbox.oneautoapi.com/brego/ireland/valuationfromvin?vehicle_identification_number=abcde1234f56789101¤t_kms=10231
Request Parameters
vehicle_identification_number
mandatory, string, e.g. abcde1234f56789101
The vehicle identification number
current_kms
mandatory, string, e.g. 10231
Current mileage of the vehicle in kms
Sample Response
{
"success": true,
"result": {
"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,
"brego_derivative_id": "0a1bc3d4-ef56-789g-h10i-j111k21l3m14",
"vehicle_identification_number": "abcde123fg45678910",
"currency_unit": "eur",
"mileage_unit": "km",
"version": "2024-05-01",
"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. 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
brego_derivative_id
e.g. 0a1bc3d4-ef56-789g-h10i-j111k21l3m14
The Brego Derivative ID.
vehicle_identification_number
e.g. abcde123fg45678910
Vehicle identification number (VIN).
currency_unit
e.g. eur
The currency unit.
mileage_unit
e.g. km
The mileage unit.
version
e.g. 2024-05-01
Date point of the valuation
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