Ireland’s leading vehicle history check - includes write-off, mileage, tax, outstanding finance and vehicle specification data.
Comprehensive vehicle history and market intelligence, with technical and specification data suitable for detailed car buying reports and sales listings.
Note: This is an asynchronous API method (see our implementation guide). Partial results are returned immediately while finance queries continue processing in the background.
Finance data is typically available within 10–20 seconds, but may take longer if extended manual checks are required.
Key Features
Vehicle Identity Check
Import Check
Finance Check
Mileage Check
NCT, Tax & Ownership
Vehicle Data
Pricing
| Plan | GBP | EUR | USD |
|---|---|---|---|
| PAYG (Per Result) | £12 | €14.40 | $16.80 |
| Business (Per Result) | £9 | €10.80 | $12.60 |
| Enterprise (Per Result) | £6 | €7.20 | $8.40 |
Documentation
Introduction
Header
When making calls to our API, include the following header:
Example Request
https://api.oneautoapi.com/cartell/vehiclehistorycheck/?vehicle_registration_mark=AB21ABC¤t_mileage=12345&callback_url=https://webhookexample/l235o5abcde6f/receiver&return_data_in_callback=true
Example Sandbox Request
https://sandbox.oneautoapi.com/cartell/vehiclehistorycheck/?vehicle_registration_mark=AB21ABC¤t_mileage=12345&callback_url=https://webhookexample/l235o5abcde6f/receiver&return_data_in_callback=true
Request Parameters
Sample Response
{
"success": true,
"result": {
"function": "Vehicle History Check",
"status": "Accepted",
"callback_url": "https://webhookexample/l235o5abcde6f/receiver",
"message": "As a callback_url was not provided you will need to poll this method until a non-202 result is returned. Once the data has been retrieved you have up to 24 hours to request the result before it is deleted.",
"report_details": {
"car_history_check_report_id": "IET-12A34B",
"report_state": "completed",
"basic_vehicle_info": {
"vehicle_registration_mark": "12MH3345",
"manufacturer_desc": "Mini",
"model_range_desc": "Hatch",
"derivative_desc": "1.5 Cooper Classic Hatchback 3dr Petrol Manual Euro 6 (s/s) (136 ps)",
"fuel_type_desc": "Petrol",
"transmission_desc": "Automatic",
"engine_capacity_cc": 1499
},
"car_history_check_report_public_url": "https://www.cartell.ie/ssl/servlet/viewReportByKey?viewKey=4f2fb520-8425-4729-ac5a-fda4ef459c7e",
"report_summary": {
"is_finance_outstanding": true,
"is_mileage_discrepancy": true,
"is_written_off": true,
"is_other_alerts": false,
"is_warnings": true
},
"report_details": {
"vehicle_details": {
"manufacturer_desc": "Mini",
"model_range_desc": "Hatch",
"derivative_desc": "1.5 Cooper Classic Hatchback 3dr Petrol Manual Euro 6 (s/s) (136 ps)",
"engine_capacity_cc": 1968,
"fuel_type_desc": "Petrol",
"transmission_desc": "Manual",
"power_desc": "109BHP",
"co2_gkm": 123,
"body_type_desc": "hatchback",
"colour": "RED",
"gross_vehicleweight_kg": 2359,
"number_doors": 2,
"number_seats": 4,
"number_windows": 6,
"manufactured_year": 2020,
"introduction_date": "2020-01-01"
},
"vehicle_identity": {
"vehicle_identification_number": "ABCDE123456F78910",
"engine_number": "A12345678",
"first_registration_date": "2020-01-01",
"first_registration_ireland_date": "2020-01-01",
"last_sold_date": "2024-06-07",
"number_previous_owners": 1,
"number_owners": 2,
"chassis_details": "back bone",
"country_of_origin": "United Kingdom",
"country_of_assembly": "Poland"
},
"vehicle_status": {
"is_taxed": true,
"nct_applicable": true,
"cvrt_applicable": true,
"roadworthiness_test_status": "CURRENT",
"vehicle_taxation_class_desc": "PRIVATE",
"owner_type": "GARAGE"
},
"import_export_data": {
"irish_data": {
"is_imported": true,
"imported_date": "2020-01-01",
"imported_from_country": "UK",
"prior_vrm": "AB21ABC",
"is_exported": true,
"exported_date": "2020-01-01",
"exported_to_country": "UK",
"vrt_category": "A",
"vrt_rate": 37,
"vat_rate": 23,
"mrrp": 35785
},
"uk_data": {
"vehicle_registration_mark": "12MH3345",
"manufacturer_desc": "Mini",
"model_range_desc": "Hatch",
"derivative_desc": "1.5 Cooper Classic Hatchback 3dr Petrol Manual Euro 6 (s/s) (136 ps)",
"is_imported": true,
"is_exported": true
}
},
"finance_data": {
"finance_check_start": "2020-01-01",
"finance_check_complete": "2020-01-01",
"finance_check_result": "No Finance",
"finance_company": "A FINANCE CO",
"finance_type": "HIRE PURCHASE",
"finance_start_date": "2020-01-01",
"finance_term_months": 12
},
"miaftr": {
"miaftr_ireland": "Clear",
"miaftr_damage_level": "Insurer Alert",
"source": "MIAFTR",
"recovered_category": "B",
"vehicle_registration_mark": "123-D-45678",
"vehicle_identification_number": "ABCDE123456F78910"
},
"mileage": {
"is_mileage_discrepancy": true,
"mileage_data_qty": 1,
"mileage_data_items": [
{
"source_of_mileage_observation": "INITIAL READING",
"date_of_mileage_observation": "2020-01-01",
"mileage_observed": 12345,
"mileage_unit": "kms"
}
]
},
"nct_details": {
"nct_due_date": "2025-01-01",
"nct_cost": 55,
"nct_expired_months": 1,
"nct_remaining_months": 11,
"nct_schedule_list": [
"2026-01-01",
"2025-01-01",
"2024-01-01"
],
"nct_pass_dates_list": [
{
"test_date": "2024-01-10",
"interval_months": 10
}
]
},
"cvrt_details": {
"cvrt_expiry_date": "2025-01-01",
"cvrt_type": "LCV",
"cvrt_expired_months": 2,
"cvrt_remaining_months": 11,
"cvrt_timeline": [
{
"cvrt_due_date": "2024-01-01",
"cvrt_recorded_date": "2025-01-01",
"interval_months": 10
}
]
},
"tax_details": {
"tax_expiry_date": "2020-01-01",
"annual_tax_euro": 333,
"vehicle_taxation_class": "GOODS",
"tax_remaining_months": 1,
"tax_remaining_value_euro": 15
},
"tax_class_changes": {
"tax_class_timeline": [
{
"tax_class_change_date": "2025-12-15",
"vehicle_taxation_class": "PRIVATE"
}
]
},
"tax_dates_list": [
{
"tax_expiry_date": "2025-12-15",
"tax_recorded_date": "2024-12-15",
"tax_interval_months": 12
}
],
"owner_history_items": [
{
"owner_type": "GARAGE",
"date_purchased": "2023-09-13",
"date_sold": "2025-12-09",
"ownership_duration_months": 26
}
],
"cartell_price_guide": {
"retail_valuation_excellent": 9000,
"retail_valuation_good": 7900,
"retail_valuation_fair": 6850,
"trade_valuation_excellent": 6750,
"trade_valuation_good": 5650,
"trade_valuation_fair": 4600
},
"performance_data": {
"max_speed_kmh": 167,
"max_speed_mph": 104,
"acceleration_0to62_mph_seconds": 13.5,
"power_kw": 75,
"power_bhp": 102,
"power_rpm": 4400,
"torque_nm": 250,
"torque_lbft": 184,
"torque_rpm": 1500,
"drive_type_desc": "Standard",
"driving_axle": "Front"
},
"technical_data": {
"engine_code": "CAYD",
"cylinder_arrangement": "In-line",
"engine_bore_mm": 79.5,
"engine_stroke_mm": 80.5,
"valve_gear": "Double Overhead Cams",
"aspiration": "Turbo",
"number_cylinders": 4,
"valves_per_cylinder": 4,
"fuel_delivery": "Diesel Commom Rail",
"has_diesel_particulate_filter": true,
"number_gears": 1
},
"dimension_capacities_data": {
"vehicle_height_mm": 1836,
"vehicle_length_mm": 4876,
"vehicle_width_mm": 1794,
"fuel_capacity_litres": 60,
"bootspace_litres": 530,
"head_room_front_mm": 989,
"head_room_rear_mm": 989,
"hip_room_front_mm": 1200,
"hip_room_rear_mm": 1150,
"shoulder_room_front_mm": 1200,
"shoulder_room_rear_mm": 1150
},
"wheel_tyre_data": {
"tyre_size_front": "205/55/16 94H",
"tyre_type_front": "Conventional/summer",
"tyre_size_rear": "205/55/16 94H",
"tyre_type_rear": "Conventional/summer",
"rim_size_front_inch": "16 x6.0",
"wheel_type_front": "Alloy",
"rim_size_rear_inch": "16 x6.0",
"wheel_type_rear": "Alloy"
},
"equipment_data_list": [
{
"item": "Start/Stop",
"item_value": "No"
}
],
"lights_brakes_data_list": [
{
"item": "Front Fog Lights",
"item_value": "Yes"
}
],
"safety_comfort_data": [
{
"item": "Side Airbag",
"item_value": "Yes"
}
],
"warranty_data": {
"vehicle": {
"warranty_months": 36,
"warranty_km": 100000,
"warranty_expiry_date": "Expired"
},
"roadside_assistance": {
"warranty_months": 36,
"warranty_km": 100000,
"warranty_expiry_date": "Expired"
},
"anti_corrosion": {
"warranty_months": 144,
"warranty_km": 100000,
"warranty_expiry_date": "Expired"
},
"paint": {
"warranty_months": 36,
"warranty_km": 100000,
"warranty_expiry_date": "Expired"
},
"powertrain": {
"warranty_months": 36,
"warranty_km": 100000,
"warranty_expiry_date": "Expired"
}
},
"validation_data": {
"registration_certificate_number": "C177***127",
"nct_certificate_number": "#00#7#####1"
},
"previous_searches_list": [
{
"date_of_search": "2026-02-19",
"type_of_search": "History",
"customer_type": "Trade"
}
],
"previous_listings_list": [
{
"advert_heading": "Volkswagen Golf - 20000 KM - Diesel - Hatchback Manual",
"first_seen_date": "2025-05-09",
"advertised_price": 37500,
"source": "Carsite"
}
],
"similar_listings_list": [
{
"advert_id": "1234567",
"advert_heading": "Volkswagen Golf - 20000 KM - Diesel - Hatchback Manual",
"last_seen_date": "2026-02-21",
"advertised_price": 33950,
"advert_status": "Live",
"vehicle_details_page_url": "http://www.advert.com/advert=12345"
}
],
"cartell_intelligence_guide": {
"vehicle_parc_qty": 623,
"average_previous_owners": 1.8,
"nvdf_last_period_sold_qty": 1,
"days_to_sold": 49,
"last_year_sales_trend": -29.4
}
}
}
},
"error": "If there is an error the message would go here"
}Response Parameters
Status Codes
Also Available From Cartell
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