UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

Condition Check

Powered by Experian Automotive

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

PAYG
80p
Per Use
Business
55p
Per Use
Enterprise
30p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)80p96c$1.12
Business (Per Use)55p66c77c
Enterprise (Per Use)30p36c42c

Sample Response

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"
      }
    ]
  },
  "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.
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