Retrieve valuation data at reduced cost using a stored Brego Derivative ID - perfect for valuing any database of vehicles.
This method allows updated valuations to be obtained at reduced cost and is particularly useful when used in combination with the search endpoint to value assets where a manual lookup is required e.g. motorhomes and caravans.
Key Features
ID-based Lookup
Reduced cost lookup with no reliance on VRM or VIN
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/valuationfromid?brego_derivative_id=0a1bc3d4-ef56-789g-h10i-j111k21l3m14¤t_mileage=10231®istration_date=2020-01-01&valuation_date=2024-05-01
Example Sandbox Request
https://sandbox.oneautoapi.com/brego/valuationfromid?brego_derivative_id=0a1bc3d4-ef56-789g-h10i-j111k21l3m14¤t_mileage=10231®istration_date=2020-01-01&valuation_date=2024-05-01
Request Parameters
brego_derivative_id
mandatory, string, e.g. 0a1bc3d4-ef56-789g-h10i-j111k21l3m14
The Brego Derivative ID
current_mileage
mandatory, string, e.g. 10231
Current mileage of the vehicle in full
registration_date
mandatory, string, e.g. 2020-01-01
Date the vehicle was first registered in the UK
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": 22123,
"retail_average_valuation": 23868,
"retail_high_valuation": 25742,
"trade_low_valuation": 19247,
"trade_average_valuation": 20765,
"trade_high_valuation": 22396,
"current_mileage": 20000,
"brego_derivative_id": "0a1bc3d4-ef56-789g-h10i-j111k21l3m14",
"currency_unit": "gbp",
"mileage_unit": "mi",
"version": "2024-05-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. 22123
The suggested retail low valuation including VAT for the specified vehicle.
retail_average_valuation
e.g. 23868
The suggested retail average valuation including VAT for the specified vehicle.
retail_high_valuation
e.g. 25742
The suggested retail high valuation including VAT for the specified vehicle .
trade_low_valuation
e.g. 19247
The suggested trade low valuation including VAT for the specified vehicle.
trade_average_valuation
e.g. 20765
The suggested trade average valuation including VAT for the specified vehicle.
trade_high_valuation
e.g. 22396
The suggested trade high valuation including VAT for the specified vehicle.
current_mileage
e.g. 20000
Current mileage of the vehicle
brego_derivative_id
e.g. 0a1bc3d4-ef56-789g-h10i-j111k21l3m14
The Brego Derivative ID.
currency_unit
e.g. gbp
The currency unit.
mileage_unit
e.g. mi
The mileage unit.
version
e.g. 2024-05-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