VS&TD Write-Off Data & Vehicle Identity Verification
Protect your financial interests and reputation.
You are legally obliged to inform potential buyers when advertising a vehicle if it has been written off. This service helps you to comply with your obligations by checking the Motor Insurers Bureau (MIB) VS&TD (formerly MIAFTR) database.
It also provides vital protection against overvaluing purchaes, with automated checks contributing to efficient sales processes.
Key Features
Identify Write-offs
Identifies write-offs recorded in the insurance industries MIAFTR database.
Vehicle Identity Checks
The date and result of any physical identity checks carried out.
VIN Check
Check the VIN matches the DVLA record.
Import, Export & Scrapped Markers
Identify imports, and vehicles that should not be on the road.
Engine Number
For ease of parts identification.
Technical Data
Includes 15 additional fields of technical data.
Pricing
| Plan | GBP | EUR | USD |
|---|---|---|---|
| PAYG (Per Use) | 80p | 96c | $1.12 |
| Business (Per Use) | 55p | 66c | 77c |
| Enterprise (Per Use) | 30p | 36c | 42c |
V3
Documentation
Introduction
This endpoint returns Motor Insurers Anti-Fraud and Theft Register (MIAFTR) data including date and type of loss, damage category and insurer details. 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/conditioncheck?vehicle_registration_mark=AB21ABC&vehicle_identification_number=ABCDE123456F78910
Example Sandbox Request
https://sandbox.oneautoapi.com/experian/conditioncheck?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"
}
],
"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"
}
]
}
]
},
"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
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
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
Also Available From Experian
Data Providers:
Auto TraderAutoPredictBregoCarketaCartellCazanaClearWattEV DatabaseEVOX ImagesExperianEzyvinMarketcheckPlate2VinRecall HQSagacitySalvageGuideSolifi Vehicle DataVIN AuditVehicle Data GlobalVehicle ImageryCategories:
Car ImagesCar Mileage ChecksCar SpecificationElectric Vehicle DataLicense Plate to VINOE VIN LookupRegistration (VRM) LookupSMR DataService HistoryVIN DecoderVehicle Build SheetVehicle DataVehicle History ChecksVehicle Recall ChecksVehicle Technical DataVehicle ValuationsSolutions:
Aftermarket & PartsAuction & RemarketingAutomotive Data ReportsCar Buying PlatformsConsultancy ServicesConsumer Websites & AppsData CleansingData ProvidersFinance BrokersFleet OperatorsFranchised DealersIndependent DealersLead ManagementLeasing & Fleet ManagementLeasing BrokersManufacturersMotor FinanceMotor InsuranceRetail Pricing StrategiesScrap & SalvageSoftware DevelopersVehicle Appraisal SoftwareVehicle AssessorsVehicle History ReportsWhole Life Costs