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
Key vehicle details, number of owners, VIN and date of registration
Import Check
If the vehicle was imported, identifies the previous registration mark and date of import
Finance Check
Checks the finance status of the vehicle with every bank in Ireland, supported by manual verification (where necessary)
Mileage Check
Provides a timeline of observation from multiple sources for peace of mind
NCT, Tax & Ownership
Provides test dates, tax status and change of ownership timeline
Vehicle Data
Comprehensive payload of technical, specification and warranty data
Sample Response
V1
Documentation
Introduction
Ireland’s leading vehicle history check - includes write-off, mileage, tax, outstanding finance and vehicle specification data.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
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
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number (VRM).
current_mileage
mandatory, string, e.g. 12345
Current mileage of the vehicle
callback_url
optional, string, e.g. https://webhookexample/l235o5abcde6f/receiver
The callback URL
return_data_in_callback
optional, string, e.g. true
Whether the callback should contain the data from the result.
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
success
e.g. true
Whether the api call was successful
function
e.g. Vehicle History Check
Cartell dataset.
status
e.g. Accepted
Vehicle History Check status.
callback_url
e.g. https://webhookexample/l235o5abcde6f/receiver
The callback URL
message
e.g. 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.
Message.
car_history_check_report_id
e.g. IET-12A34B
Cartell Car History Check report ID.
report_state
e.g. completed
Vehicle History Report status.
vehicle_registration_mark
e.g. 12MH3345
Vehicle registration number (VRM).
manufacturer_desc
e.g. Mini
Manufacturer description
model_range_desc
e.g. Hatch
Model range description.
derivative_desc
e.g. 1.5 Cooper Classic Hatchback 3dr Petrol Manual Euro 6 (s/s) (136 ps)
Derivative description.
fuel_type_desc
e.g. Petrol
The vehicle's fuel type description
transmission_desc
e.g. Automatic
The vehicle's transmission type
engine_capacity_cc
e.g. 1499
Cubic capacity of the engine.
car_history_check_report_public_url
e.g. https://www.cartell.ie/ssl/servlet/viewReportByKey?viewKey=4f2fb520-8425-4729-ac5a-fda4ef459c7e
Car History Check Report public url.
is_finance_outstanding
e.g. true
Is finance outstanding.
is_mileage_discrepancy
e.g. true
Is there a mileage discrepancy.
is_written_off
e.g. true
Has the vehicle been written off.
is_other_alerts
e.g. false
Are there any other alerts.
is_warnings
e.g. true
Is there a warning.
manufacturer_desc
e.g. Mini
Manufacturer description
model_range_desc
e.g. Hatch
Model range description.
derivative_desc
e.g. 1.5 Cooper Classic Hatchback 3dr Petrol Manual Euro 6 (s/s) (136 ps)
Derivative description.
engine_capacity_cc
e.g. 1968
Cubic capacity of the engine.
fuel_type_desc
e.g. Petrol
The vehicle's fuel type description
transmission_desc
e.g. Manual
The vehicle's transmission type
power_desc
e.g. 109BHP
Describes the power output of the vehicle.
co2_gkm
e.g. 123
CO2 in g/km
body_type_desc
e.g. hatchback
The body type description
colour
e.g. RED
Exterior colour of vehicle.
gross_vehicleweight_kg
e.g. 2359
Total weight of the vehicle including the Kerb Weight and Payload Weight in kilograms.
number_doors
e.g. 2
Number of doors.
number_seats
e.g. 4
Number of seats.
number_windows
e.g. 6
The number of windows.
manufactured_year
e.g. 2020
Year of manufacture.
introduction_date
e.g. 2020-01-01
The date the derivative was introduced.
vehicle_identification_number
e.g. ABCDE123456F78910
Vehicle identification number (VIN).
engine_number
e.g. A12345678
Vehicle engine number.
first_registration_date
e.g. 2020-01-01
Date of first registration.
first_registration_ireland_date
e.g. 2020-01-01
The date the vehicle was first registered in Ireland.
last_sold_date
e.g. 2024-06-07
The date on which the vehicle was last sold.
number_previous_owners
e.g. 1
The number of previous owners including garages.
number_owners
e.g. 2
The number of owners, including the current owner including garages.
chassis_details
e.g. back bone
Chassis details.
country_of_origin
e.g. United Kingdom
Where the vehicle was made and manufactured.
country_of_assembly
e.g. Poland
Where the vehicle was assembled.
is_taxed
e.g. true
Is the vehicle taxed.
nct_applicable
e.g. true
Is the National Car Test applicable.
cvrt_applicable
e.g. true
Is the Commercial Vehicle Roadworthiness Test applicable.
roadworthiness_test_status
e.g. CURRENT
National Car Test (NCT) Roadworthiness test status.
vehicle_taxation_class_desc
e.g. PRIVATE
Vehicle taxation class based on type of use.
owner_type
e.g. GARAGE
Owner type.
is_imported
e.g. true
Vehicle is imported.
imported_date
e.g. 2020-01-01
Date vehicle was imported
imported_from_country
e.g. UK
Country the vehicle was imported from.
prior_vrm
e.g. AB21ABC
Prior VRM.
is_exported
e.g. true
Vehicle is exported.
exported_date
e.g. 2020-01-01
Date vehicle was exported.
exported_to_country
e.g. UK
Country the vehicle was imported to.
vrt_category
e.g. A
The VRT category.
vrt_rate
e.g. 37
The VRT rate.
vat_rate
e.g. 23
The VAT rate.
mrrp
e.g. 35785
Manufacturer's recommended retail price.
vehicle_registration_mark
e.g. 12MH3345
Vehicle registration number (VRM).
manufacturer_desc
e.g. Mini
Manufacturer description
model_range_desc
e.g. Hatch
Model range description.
derivative_desc
e.g. 1.5 Cooper Classic Hatchback 3dr Petrol Manual Euro 6 (s/s) (136 ps)
Derivative description.
is_imported
e.g. true
Vehicle is imported.
is_exported
e.g. true
Vehicle is exported.
finance_check_start
e.g. 2020-01-01
Finance check start date.
finance_check_complete
e.g. 2020-01-01
Finance check completed date.
finance_check_result
e.g. No Finance
Finance check result.
finance_company
e.g. A FINANCE CO
The finance company.
finance_type
e.g. HIRE PURCHASE
The finance type.
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.
miaftr_ireland
e.g. Clear
MIAFTR Ireland status.
miaftr_damage_level
e.g. Insurer Alert
MIAFTR damage level
source
e.g. MIAFTR
The source of the data
recovered_category
e.g. B
Recovered category
vehicle_registration_mark
e.g. 123-D-45678
Vehicle registration number (VRM).
vehicle_identification_number
e.g. ABCDE123456F78910
Vehicle identification number (VIN).
is_mileage_discrepancy
e.g. true
Is there a mileage discrepancy.
mileage_data_qty
e.g. 1
The mileage data quantity
source_of_mileage_observation
e.g. INITIAL READING
The source of the mileage observation
date_of_mileage_observation
e.g. 2020-01-01
The date of the mileage observation
mileage_observed
e.g. 12345
Vehicle odometer reading
mileage_unit
e.g. kms
The mileage unit.
nct_due_date
e.g. 2025-01-01
The date on which the NCT test is due.
nct_cost
e.g. 55
The cost of the National Car Test (NCT) in Euro.
nct_expired_months
e.g. 1
Number of months since the National Car Test (NCT) expired.
nct_remaining_months
e.g. 11
The number of months remaining on the current National Car Test (NCT).
test_date
e.g. 2024-01-10
The battery test date
interval_months
e.g. 10
The number of months between National Car Tests (NCT) based on age of vehicle.
cvrt_expiry_date
e.g. 2025-01-01
The Commercial Vehicle Roadworthiness Test (CVRT) expiry date.
cvrt_type
e.g. LCV
Commercial Vehicle Roadworthiness Test (CVRT) type.
cvrt_expired_months
e.g. 2
Months since Commercial Vehicle Roadworthiness Test (CVRT) expired.
cvrt_remaining_months
e.g. 11
Months remaining on current Commercial Vehicle Roadworthiness Test (CVRT).
cvrt_due_date
e.g. 2024-01-01
Commercial Vehicle Roadworthiness Test (CVRT) due date.
cvrt_recorded_date
e.g. 2025-01-01
Commercial Vehicle Roadworthiness Test (CVRT) recorded date.
interval_months
e.g. 10
The number of months between National Car Tests (NCT) based on age of vehicle.
tax_expiry_date
e.g. 2020-01-01
The date the vehicle tax expires.
annual_tax_euro
e.g. 333
The annual tax in Euro.
vehicle_taxation_class
e.g. GOODS
Vehicle taxation class, determined from Type Approval Category,
tax_remaining_months
e.g. 1
The number of months left on current taxed period.
tax_remaining_value_euro
e.g. 15
The value of tax paid that remains until the end of the tax period.
tax_class_change_date
e.g. 2025-12-15
Tax Class change date.
vehicle_taxation_class
e.g. PRIVATE
Vehicle taxation class, determined from Type Approval Category,
tax_expiry_date
e.g. 2025-12-15
The date the vehicle tax expires.
tax_recorded_date
e.g. 2024-12-15
Date the vehicle was taxed.
tax_interval_months
e.g. 12
Number of months since previously taxed.
owner_type
e.g. GARAGE
Owner type.
date_purchased
e.g. 2023-09-13
The date the owner puchased the vehicle.
date_sold
e.g. 2025-12-09
The date the vehicle was sold.
ownership_duration_months
e.g. 26
The number of months the vehicle was owned.
retail_valuation_excellent
e.g. 9000
The suggested retail valuation for the specified vehicle in excellent condition in Euro.
retail_valuation_good
e.g. 7900
The suggested retail valuation for the specified vehicle in good condition in Euro.
retail_valuation_fair
e.g. 6850
The suggested retail valuation for the specified vehicle in fair condition in Euro.
trade_valuation_excellent
e.g. 6750
The suggested trade valuation for the specified vehicle in excellent condition in Euro.
trade_valuation_good
e.g. 5650
The suggested trade valuation for the specified vehicle in good condition in Euro.
trade_valuation_fair
e.g. 4600
The suggested trade valuation for the specified vehicle in fair condition in Euro.
max_speed_kmh
e.g. 167
Manufacturers claimed maximum speed in kilometers per hour.
max_speed_mph
e.g. 104
Manufacturers claimed maximum speed in miles per hour.
acceleration_0to62_mph_seconds
e.g. 13.5
Acceleration - number of seconds to go from Zero to 62 mph
power_kw
e.g. 75
The maximum net power in kw
power_bhp
e.g. 102
Maximum BHP (Brake Horse Power) of this vehicle.
power_rpm
e.g. 4400
Maximum power described in rpm (Revolutions Per Minute).
torque_nm
e.g. 250
Maximum power described in Torque Nm (Torque Newton Metres).
torque_lbft
e.g. 184
Maximum power described in Lb/ft (Pound per foot).
torque_rpm
e.g. 1500
Maximum power described in rpm (Revolutions Per Minute).
drive_type_desc
e.g. Standard
Number of wheels the engine is delivering power to.
driving_axle
e.g. Front
Which axle the motor is delivering power to.
engine_code
e.g. CAYD
Engine code.
cylinder_arrangement
e.g. In-line
Arrangement of the cylinders within the engine.
engine_bore_mm
e.g. 79.5
Diameter measurement of the cylinder in millimetres.
engine_stroke_mm
e.g. 80.5
A measure (in millimetres) of the engine's cycle during which the piston travels from top to bottom or vice versa.
valve_gear
e.g. Double Overhead Cams
Describes the type/placement.
aspiration
e.g. Turbo
Engines aspiration description.
number_cylinders
e.g. 4
Number of cylinders within the engine.
valves_per_cylinder
e.g. 4
Number of valves per cylinder.
fuel_delivery
e.g. Diesel Commom Rail
Fuel delivery method.
has_diesel_particulate_filter
e.g. true
Vehicle has a diesel particulate filter.
number_gears
e.g. 1
Number of gears.
vehicle_height_mm
e.g. 1836
Overall height of the vehicle, including roof-bars or aerial in millimetres.
vehicle_length_mm
e.g. 4876
Overall length of the vehicle (bumper to bumper). Does not include any after market items, which may extended the length of the vehicle in millimetres.
vehicle_width_mm
e.g. 1794
Overall width, including the wing mirrors in millimetres.
fuel_capacity_litres
e.g. 60
Fuel capacity in litres.
bootspace_litres
e.g. 530
The bootspace in litres
head_room_front_mm
e.g. 989
Front headroom in millimetres.
head_room_rear_mm
e.g. 989
Rear headroom in millimetres.
hip_room_front_mm
e.g. 1200
Front hip room in millimetres.
hip_room_rear_mm
e.g. 1150
Rear hip room in millimetres.
shoulder_room_front_mm
e.g. 1200
Front shoulder room in millimetres.
shoulder_room_rear_mm
e.g. 1150
Rear shoulder room in millimetres.
tyre_size_front
e.g. 205/55/16 94H
Front tyre size
tyre_type_front
e.g. Conventional/summer
Front tyre type.
tyre_size_rear
e.g. 205/55/16 94H
The rear tyre size.
tyre_type_rear
e.g. Conventional/summer
Rear tyre type.
rim_size_front_inch
e.g. 16 x6.0
Front tyre rim size in inches
wheel_type_front
e.g. Alloy
Front wheel type.
rim_size_rear_inch
e.g. 16 x6.0
Rear tyre rim size in inches
wheel_type_rear
e.g. Alloy
Rear wheel type.
item
e.g. Start/Stop
Item description.
item_value
e.g. No
Item value.
item
e.g. Front Fog Lights
Item description.
item_value
e.g. Yes
Item value.
item
e.g. Side Airbag
Item description.
item_value
e.g. Yes
Item value.
warranty_months
e.g. 36
Warranty months.
warranty_km
e.g. 100000
Maximum distance in kilometres a vehicle can travel before its manufacturer's warranty expires.
warranty_expiry_date
e.g. Expired
Warranty expiry status.
warranty_months
e.g. 36
Warranty months.
warranty_km
e.g. 100000
Maximum distance in kilometres a vehicle can travel before its manufacturer's warranty expires.
warranty_expiry_date
e.g. Expired
Warranty expiry status.
warranty_months
e.g. 144
Warranty months.
warranty_km
e.g. 100000
Maximum distance in kilometres a vehicle can travel before its manufacturer's warranty expires.
warranty_expiry_date
e.g. Expired
Warranty expiry status.
warranty_months
e.g. 36
Warranty months.
warranty_km
e.g. 100000
Maximum distance in kilometres a vehicle can travel before its manufacturer's warranty expires.
warranty_expiry_date
e.g. Expired
Warranty expiry status.
warranty_months
e.g. 36
Warranty months.
warranty_km
e.g. 100000
Maximum distance in kilometres a vehicle can travel before its manufacturer's warranty expires.
warranty_expiry_date
e.g. Expired
Warranty expiry status.
registration_certificate_number
e.g. C177***127
Registration certificate number.
nct_certificate_number
e.g. #00#7#####1
NCT certificate number.
date_of_search
e.g. 2026-02-19
Date of the last search.
type_of_search
e.g. History
Type of search
customer_type
e.g. Trade
Customer type.
advert_heading
e.g. Volkswagen Golf - 20000 KM - Diesel - Hatchback Manual
Advert heading
first_seen_date
e.g. 2025-05-09
First seen date for the current listing
advertised_price
e.g. 37500
The advertised price of the vehicle
source
e.g. Carsite
The source of the data
advert_id
e.g. 1234567
Advert Id
advert_heading
e.g. Volkswagen Golf - 20000 KM - Diesel - Hatchback Manual
Advert heading
last_seen_date
e.g. 2026-02-21
Last seen date for the current listing
advertised_price
e.g. 33950
The advertised price of the vehicle
advert_status
e.g. Live
Advert status.
vehicle_details_page_url
e.g. http://www.advert.com/advert=12345
Url to the vehicle on the source website
vehicle_parc_qty
e.g. 623
The number of vehicles of this type in operation in Ireland.
average_previous_owners
e.g. 1.8
Average number of previous owners.
nvdf_last_period_sold_qty
e.g. 1
The number of vehicles sold in the last 3 monthly period according to the NVDF.
days_to_sold
e.g. 49
Days to sold.
last_year_sales_trend
e.g. -29.4
Last year's sales trend.
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