Identifies the Brego Derivative ID and Description for any vehicle based on its registration mark, for rapid, accurate data entry. Useful for user journeys where confirmation of vehicle details is required prior to valuation, or for coding vehicle inventory.
Key Features
VRM Lookup
Quickly and easily identify the Brego ID and description from a registration plate.
Vehicle Types
Comprehensive coverage for cars, light commercials, motorcycles, motorhomes and private goods vehicles.
Detailed Descriptions
Ensuring accurate asset verification as part of the valuation process.
DVLA Data
Includes date of registration, VIN, colour, scrapped and import markers.
Plate Changes
Cherished plate history with transfer dates.
Previous Keepers
Check for changes of ownership with dated history.
Sample Response
V2
Documentation
Introduction
This endpoint returns a Brego Derivative ID from a VRM.
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/derivativeidfromvrm?vehicle_registration_mark=AB21ABC
Example Sandbox Request
https://sandbox.oneautoapi.com/brego/derivativeidfromvrm?vehicle_registration_mark=AB21ABC
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number (VRM).
Sample Response
{
"success": true,
"result": {
"brego_derivative_id": "0a1bc3d4-ef56-789g-h10i-j111k21l3m14",
"vehicle_desc": "Mini Cooper S",
"registration_date": "2020-01-01",
"vehicle_identification_number": "ABCDE123456F78910",
"vehicle_registration_mark": "AB21ABC",
"colour": "RED",
"first_registration_year": 2020,
"is_scrapped": true,
"is_imported": true,
"is_imported_NI": true,
"keeper_changes_qty": 1,
"keeper_data_items": [
{
"date_of_last_keeper_change": "2020-01-01",
"previous_keeper_disposal_date": "2020-01-01",
"number_previous_keepers": 1
}
],
"cherished_data_qty": 1,
"cherished_data_items": [
{
"cherished_plate_transfer_date": "2022-01-01",
"current_vehicle_registration_mark": "AB21ABC",
"previous_vehicle_registration_mark": "AB21CDE"
}
]
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
brego_derivative_id
e.g. 0a1bc3d4-ef56-789g-h10i-j111k21l3m14
The Brego Derivative ID.
vehicle_desc
e.g. Mini Cooper S
The Vehicle description
registration_date
e.g. 2020-01-01
Date the vehicle was first registered in the UK.
vehicle_identification_number
e.g. ABCDE123456F78910
Vehicle identification number (VIN).
vehicle_registration_mark
e.g. AB21ABC
Vehicle registration number (VRM).
colour
e.g. RED
Exterior colour of vehicle.
first_registration_year
e.g. 2020
Year of registration
is_scrapped
e.g. true
Has the vehicle been scrapped.
is_imported
e.g. true
Vehicle is imported.
is_imported_NI
e.g. true
The vehicle is imported.
keeper_changes_qty
e.g. 1
Number of keeper changes.
date_of_last_keeper_change
e.g. 2020-01-01
Date of last keeper change.
previous_keeper_disposal_date
e.g. 2020-01-01
The date the previous keeper disposed of the vehicle.
number_previous_keepers
e.g. 1
Number of previous keepers.
cherished_data_qty
e.g. 1
The cherished data quantity.
cherished_plate_transfer_date
e.g. 2022-01-01
Plate transfer date.
current_vehicle_registration_mark
e.g. AB21ABC
Current vehicle registration mark.
previous_vehicle_registration_mark
e.g. AB21CDE
Previous vehicle registration mark.
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