Protect your interests when buying or selling vehicles with AutoCheck, the comprehensive vehicle history check from Experian.
Includes a 12 month, £20,000 Experian Data Guarantee (terms and conditions www.experian.co.uk/data-guarantee)
Key Features
£20,000 Data Guarantee
Includes a 12 month, £20,000 Experian-backed indemnity (terms and conditions apply)
Outstanding Finance
Identify whether there is outstanding finance on a vehicle
Condition Data
MIAFTR data identifies vehicles previously written-off by an insurer
Stolen Status
Police National Computer (PNC) data identifies whether a vehicle is currently marked as stolen
Keeper & Plate Change History
Identify previous keeper and plate changes
High Risk Markers
Identifies where a security marker has been added to a vehicle by an interested party (B2B only)
Sample Response
V3
Documentation
Introduction
This endpoint identifies whether a vehicle has outstanding finance, is recorded as stolen or has previously been written off, along with a 12 month, £20,000 Experian Data Guarantee (see: www.experian.co.uk/data-guarantee). Please read our 'Understanding status codes' Knowledge Base article on handling VOID VRM (206) responses before implementing this endpoint.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/experian/autocheck-20k-guarantee?vehicle_registration_mark=AB21ABC&vehicle_identification_number=ABCDE123456F78910
Example Sandbox Request
https://sandbox.oneautoapi.com/experian/autocheck-20k-guarantee?vehicle_registration_mark=AB21ABC&vehicle_identification_number=ABCDE123456F78910
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number
vehicle_identification_number
optional, string, e.g. ABCDE123456F78910
Vehicle identification number
Sample Response
{
"success": true,
"result": {
"date_last_updated": "2020-01-01",
"vehicle_registration_mark": "AB21ABC",
"does_vehicle_registration_mark_match": false,
"does_vehicle_identification_number_match": true,
"dvla_manufacturer_desc": "NISSAN",
"dvla_model_desc": "QASHQAI ACENTA PREMIUM DCI",
"dvla_fuel_desc": "DIESEL",
"dvla_body_desc": "5 DOOR HATCHBACK",
"dvla_doorplan_code": 14,
"dvla_transmission_code": "M",
"dvla_transmission_desc": "MANUAL 6 GEARS",
"number_gears": 6,
"mvris_code": "A1ABC",
"mvris_manufacturer_code": "A1",
"mvris_model_code": "ABC",
"dvla_dtp_manufacturer_code": "AB",
"dvla_dtp_model_code": "587",
"number_seats": 5,
"dvla_wheelplan": "2 AXLE RIGID BODY",
"registration_date": "2020-01-01",
"manufactured_year": 2020,
"vehicle_identification_number": "ABCDE123456F78910",
"first_registration_date": "2020-01-01",
"used_before_first_registration": true,
"co2_gkm": 123,
"engine_capacity_cc": 1234,
"engine_number": "A12345678",
"is_scrapped": true,
"scrapped_date": "2020-01-01",
"certificate_of_destruction_issued": true,
"is_exported": true,
"was_exported": false,
"exported_date": "2020-01-01",
"is_imported": true,
"imported_date": "2020-01-01",
"is_non_eu_import": true,
"prior_gb_vrm": "AB21ABC",
"prior_ni_vrm": "ABC1234",
"colour": "RED",
"original_colour": "BLUE",
"number_previous_colours": 1,
"maximum_permissable_mass_kg": 1234,
"power_weight_ratio_kw_kg": 0.1234,
"min_kerbweight_kg": 1234,
"gross_vehicleweight_kg": 1234,
"max_netpower_kw": 12,
"max_braked_towing_weight_kg": 1234,
"max_unbraked_towing_weight_kg": 123,
"stationary_soundlevel_db": 12,
"stationary_soundlevel_rpm": 1234,
"driveby_soundlevel_db": 12,
"v5c_data_qty": 1,
"v5c_data_items": [
{
"date_v5c_issued": "2020-01-01"
}
],
"vehicle_identity_check_qty": 1,
"vehicle_identity_check_items": [
{
"date_of_vehicle_identity_check": "2020-01-01",
"result_of_vehicle_identity_check": "Pass"
}
],
"keeper_changes_qty": 1,
"keeper_data_items": [
{
"date_last_updated": "2020-01-01",
"number_previous_keepers": 1,
"date_of_last_keeper_change": "2020-01-01"
}
],
"colour_changes_qty": 1,
"colour_data_items": [
{
"date_last_updated": "2020-01-01",
"number_previous_colours": 1,
"date_of_last_colour_change": "2020-01-01",
"last_colour": "BLUE"
}
],
"finance_data_qty": 1,
"finance_data_items": [
{
"date_last_updated": "2020-01-01",
"finance_start_date": "2020-01-01",
"finance_term_months": 12,
"finance_type": "HIRE PURCHASE",
"finance_company": "A FINANCE CO",
"finance_company_contact_number": "01234 567891",
"finance_agreement_number": "S1234567",
"financed_vehicle_desc": "NISSAN QASHQAI ACENTA"
}
],
"cherished_data_qty": 1,
"cherished_data_items": [
{
"cherished_plate_transfer_date": "2020-01-01",
"previous_vehicle_registration_mark": "AB21ABC",
"date_of_receipt": "2020-01-01",
"transfer_type": "Marker",
"current_vehicle_registration_mark": "AB21ABC"
}
],
"condition_data_qty": 1,
"condition_data_items": [
{
"date_last_updated": "2020-01-01",
"date_of_loss": "2020-01-01",
"vehicle_status": "RECOVERED - NON-STRUCTURE DAMAGE",
"theft_indictor_literal": "RECOVERED",
"date_of_miaftr_entry": "2020-01-01",
"insurer_name": "EXAMPLE INSURANCE CO",
"insurer_contact_number": "01234 567891",
"insurer_claim_number": "EXAMPLE",
"loss_type": "T",
"recovered_category_desc": "Non-structure damage",
"recovered_category": "N",
"insurer_make": "NISS",
"insurer_model": "QAS",
"insurer_code": "1234",
"insurer_branch": 12345,
"theft_indicator": "R",
"date_removed": "2020-01-01",
"cause_of_damage": "Accident",
"damage_location_items": [
{
"damage_location_desc": "FrontOffside"
}
]
}
],
"stolen_vehicle_data_qty": 1,
"stolen_vehicle_data_items": [
{
"date_last_updated": "2020-01-01",
"date_reported": "2020-01-01",
"is_stolen": false,
"police_force": "COUNTY POLICE FORCE",
"police_force_contact_number": "01234 567891"
}
],
"high_risk_data_qty": 1,
"high_risk_data_items": [
{
"date_last_updated": "2020-01-01",
"date_of_interest": "2020-01-01",
"registration_period": 12,
"high_risk_type": "AT RISK",
"extra_information": "Additional information relating to high risk",
"company_name": "A FINANCE CO",
"company_contact_number": "01234 567891",
"company_contact_reference": "Reference"
}
],
"previous_search_qty": 1,
"previous_search_items": [
{
"date_of_search": "2021-08-14",
"time_of_search": "10:56:18",
"business_type_searching": "MOTOR TRADE & OTHER"
}
],
"salvage_check_result": {
"salvage_auction_record_found": true,
"salvage_auction_records": [
{
"salvage_auction_record_id": 1234567,
"salvage_auction_reference": 1234567,
"salvage_auction_lot_desc": "CAT B - Breaker",
"salvage_auction_lot_date": "2020-01-01",
"mileage": 12345,
"primary_damage_desc": "Rear End",
"secondary_damage_desc": "Side",
"salvage_auction_location": "York",
"external_image_urls": [
"http://exampleauctionhouse/example/12345"
]
}
]
},
"indemnity_months": 12,
"indemnity_gbp": 10000
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
date_last_updated
e.g. 2020-01-01
Date record was last updated
vehicle_registration_mark
e.g. AB21ABC
Vehicle registration number (VRM).
does_vehicle_registration_mark_match
e.g. false
Does the VRM returned in the response match the input VRM
does_vehicle_identification_number_match
e.g. true
Does the supplied vehicle_registration_mark and vehicle_identifcation input parameters match.
dvla_manufacturer_desc
e.g. NISSAN
DVLA manufacturer description.
dvla_model_desc
e.g. QASHQAI ACENTA PREMIUM DCI
DVLA model description.
dvla_fuel_desc
e.g. DIESEL
DVLA fuel description.
dvla_body_desc
e.g. 5 DOOR HATCHBACK
DVLA body description.
dvla_doorplan_code
e.g. 14
DVLA door plan code.
dvla_transmission_code
e.g. M
DVLA transmission code.
dvla_transmission_desc
e.g. MANUAL 6 GEARS
DVLA transmission description.
number_gears
e.g. 6
Number of gears.
mvris_code
e.g. A1ABC
MVRIS Code
mvris_manufacturer_code
e.g. A1
MVRIS manufacturer code.
mvris_model_code
e.g. ABC
MVRIS model code.
dvla_dtp_manufacturer_code
e.g. AB
DVLA DTP manufacturer code.
dvla_dtp_model_code
e.g. 587
DVLA DTP model code
number_seats
e.g. 5
Number of seats.
dvla_wheelplan
e.g. 2 AXLE RIGID BODY
DVLA wheelplan code.
registration_date
e.g. 2020-01-01
Date the vehicle was first registered in the UK.
manufactured_year
e.g. 2020
Year of manufacture.
vehicle_identification_number
e.g. ABCDE123456F78910
Vehicle identification number (VIN).
first_registration_date
e.g. 2020-01-01
Date of first registration.
used_before_first_registration
e.g. true
Vehicle was used before DVLA/DLNI first registration.
co2_gkm
e.g. 123
CO2 in g/km
engine_capacity_cc
e.g. 1234
Cubic capacity of the engine.
engine_number
e.g. A12345678
Vehicle engine number.
is_scrapped
e.g. true
Has the vehicle been scrapped.
scrapped_date
e.g. 2020-01-01
Date the vehicle was scrapped.
certificate_of_destruction_issued
e.g. true
Has a certificate of destruction been issued.
is_exported
e.g. true
Vehicle is exported.
was_exported
e.g. false
Vehicle was exported.
exported_date
e.g. 2020-01-01
Date vehicle was exported.
is_imported
e.g. true
Vehicle is imported.
imported_date
e.g. 2020-01-01
Date vehicle was imported
is_non_eu_import
e.g. true
Vehicle is non-eu import.
prior_gb_vrm
e.g. AB21ABC
Previous GB vehicle registration mark
prior_ni_vrm
e.g. ABC1234
Previous NI vehicle registration mark.
colour
e.g. RED
Exterior colour of vehicle.
original_colour
e.g. BLUE
Vehicle's original colour.
number_previous_colours
e.g. 1
The number of previous colours
maximum_permissable_mass_kg
e.g. 1234
Maximum permissable mass in kilograms.
power_weight_ratio_kw_kg
e.g. 0.1234
Power to weight ratio kilowatts per kilograms.
min_kerbweight_kg
e.g. 1234
Weight of the vehicle, including a full tank of fuel and all standard equipment in kilograms.
gross_vehicleweight_kg
e.g. 1234
Total weight of the vehicle including the Kerb Weight and Payload Weight in kilograms.
max_netpower_kw
e.g. 12
Maximum net power in kilowatts.
max_braked_towing_weight_kg
e.g. 1234
Maximum braked towing weight in kilograms,
max_unbraked_towing_weight_kg
e.g. 123
Maximum unbraked towing weight in kilograms.
stationary_soundlevel_db
e.g. 12
Sound level in decibels whilst vehicle is stationary.
stationary_soundlevel_rpm
e.g. 1234
Sound level in decibels for Engine speed levels.
driveby_soundlevel_db
e.g. 12
Sound level in decibels for the drive by levels.
v5c_data_qty
e.g. 1
Number of V5C Certificates.
date_v5c_issued
e.g. 2020-01-01
Date the v5 was issued.
vehicle_identity_check_qty
e.g. 1
Number of vehicle identity checks.
date_of_vehicle_identity_check
e.g. 2020-01-01
Date of (previous) vehicle identity check(s)
result_of_vehicle_identity_check
e.g. Pass
Result of vehicle identity check
keeper_changes_qty
e.g. 1
Number of keeper changes.
date_last_updated
e.g. 2020-01-01
Date record was last updated
number_previous_keepers
e.g. 1
Number of previous keepers.
date_of_last_keeper_change
e.g. 2020-01-01
Date of last keeper change.
colour_changes_qty
e.g. 1
Colour change quantity.
date_last_updated
e.g. 2020-01-01
Date record was last updated
number_previous_colours
e.g. 1
The number of previous colours
date_of_last_colour_change
e.g. 2020-01-01
Date of last colour change.
last_colour
e.g. BLUE
Vehicle's last colour
finance_data_qty
e.g. 1
The finance data quantity.
date_last_updated
e.g. 2020-01-01
Date record was last updated
finance_start_date
e.g. 2020-01-01
The date finance agreement starts.
finance_term_months
e.g. 12
The term of finance agreement in months.
finance_type
e.g. HIRE PURCHASE
The finance type.
finance_company
e.g. A FINANCE CO
The finance company.
finance_company_contact_number
e.g. 01234 567891
The finance company contact number.
finance_agreement_number
e.g. S1234567
The finance agreement number.
financed_vehicle_desc
e.g. NISSAN QASHQAI ACENTA
The financed vehicle.
cherished_data_qty
e.g. 1
The cherished data quantity.
cherished_plate_transfer_date
e.g. 2020-01-01
Plate transfer date.
previous_vehicle_registration_mark
e.g. AB21ABC
Previous vehicle registration mark.
date_of_receipt
e.g. 2020-01-01
Recorded date of transfer at DVLA.
transfer_type
e.g. Marker
Plate transfer type.
current_vehicle_registration_mark
e.g. AB21ABC
Current vehicle registration mark.
condition_data_qty
e.g. 1
The condition data quantity.
date_last_updated
e.g. 2020-01-01
Date record was last updated
date_of_loss
e.g. 2020-01-01
Date of loss.
vehicle_status
e.g. RECOVERED - NON-STRUCTURE DAMAGE
Vehicle's stolen status.
theft_indictor_literal
e.g. RECOVERED
Theft indicator.
date_of_miaftr_entry
e.g. 2020-01-01
MIAFTR entry date.
insurer_name
e.g. EXAMPLE INSURANCE CO
Insurer's name.
insurer_contact_number
e.g. 01234 567891
Insurer's contact number.
insurer_claim_number
e.g. EXAMPLE
Insurer's claim number.
loss_type
e.g. T
The flag to indicate type of loss for old insurance motor claims.
recovered_category_desc
e.g. Non-structure damage
The recovered category description.
recovered_category
e.g. N
Recovered category
insurer_make
e.g. NISS
Insurer's manufacturer description.
insurer_model
e.g. QAS
Insurer's model description.
insurer_code
e.g. 1234
Insurer's code.
insurer_branch
e.g. 12345
Insurer's branch number.
theft_indicator
e.g. R
Theft indicator.
date_removed
e.g. 2020-01-01
Date the condition was removed.
cause_of_damage
e.g. Accident
Cause of damage.
damage_location_desc
e.g. FrontOffside
The location of the damage
stolen_vehicle_data_qty
e.g. 1
The stolen vehicle data quantity.
date_last_updated
e.g. 2020-01-01
Date record was last updated
date_reported
e.g. 2020-01-01
Date vehicle was reported as stolen.
is_stolen
e.g. false
Is the vehicle stolen
police_force
e.g. COUNTY POLICE FORCE
Investigating police force.
police_force_contact_number
e.g. 01234 567891
Investigating police force contact number.
high_risk_data_qty
e.g. 1
The high risk data quantity.
date_last_updated
e.g. 2020-01-01
Date record was last updated
date_of_interest
e.g. 2020-01-01
The date vehicle was marked as high risk.
registration_period
e.g. 12
The registration period in months.
high_risk_type
e.g. AT RISK
The high risk type.
extra_information
e.g. Additional information relating to high risk
The additional information relating to high risk.
company_name
e.g. A FINANCE CO
The company holding an interest in the vehicle.
company_contact_number
e.g. 01234 567891
The company contact number.
company_contact_reference
e.g. Reference
The company contact reference.
previous_search_qty
e.g. 1
The previous search quantity.
date_of_search
e.g. 2021-08-14
Date of the last search.
time_of_search
e.g. 10:56:18
Time of search (hh:mm:ss)
business_type_searching
e.g. MOTOR TRADE & OTHER
Type of business type conducting the check.
salvage_auction_record_found
e.g. true
Salvage record has been found
salvage_auction_record_id
e.g. 1234567
Salvage record id
salvage_auction_reference
e.g. 1234567
The salvage auction lot ID or reference number
salvage_auction_lot_desc
e.g. CAT B - Breaker
Salvage auction lot description
salvage_auction_lot_date
e.g. 2020-01-01
The salvage auction date
mileage
e.g. 12345
The current mileage of the vehicle in full
primary_damage_desc
e.g. Rear End
The primary damage description
secondary_damage_desc
e.g. Side
The secondary damage description
salvage_auction_location
e.g. York
Salvage auction's location
indemnity_months
e.g. 12
Indemnity period in months for any data guarantee purchased as part of the check,
indemnity_gbp
e.g. 10000
Indemnity amount in GBP for any data guarantee purchased as part of the check.
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