Vehicle History Check

Powered by Cartell

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

Pricing

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

Sample Response

Version

Documentation

Swagger

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&current_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&current_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

Also Available From Cartell

Data Providers:

Auto Trader AutoPredict Brego Carketa Cartell Cazana ClearWatt DriveRightData EV Database EVOX Images Experian Ezyvin Marketcheck Sagacity SalvageGuide Solifi Vehicle Data UK Vehicle Data

Categories:

Automotive Data API Car Images API Car Specification API Electric Vehicle Data API License Plate to VIN API OE VIN Lookup API Registration Lookup API Service History API VIN Decoder API Vehicle Build Sheet API Vehicle Check API Vehicle Data API Vehicle Images API Vehicle Mileage Check API Vehicle Recall Check API Vehicle Technical Data API Vehicle Valuation API

Solutions:

Aftermarket & Parts Auction & Remarketing Automotive Data Reports Car Buying Consultancy Consumer Vehicle Checks Consumer Websites Data Cleansing Data Providers Finance Brokers Fleet Operators Franchised Dealers Independent Dealers Lead Management Leasing & Fleet Management Leasing Brokers Manufacturers Motor Finance Motor Insurers Retail Pricing Scrap & Salvage Software Developers Vehicle Appraisal Software Vehicle Assessors Whole Life Cost Data

Company:

About us Blog Contact Us Knowledge Base Privacy Policy Terms and Conditions

Coverage:

Europe Vehicle Data API Ireland Vehicle Data API UK Vehicle Data API US Vehicle Data API