VRM Lookup for Ireland - providing registration and technical data, with NCT due date.
Cartell are the leading vehicle check provider in Ireland, providing highly accurate and comprehensive data.
Key Features
VRM-based Lookup
Easily identify vehicles by registration mark
NCT Details
Includes description, date or registration along with import and export markers.
NCT Due Date
Identifies the due date for the vehicles next National Car Test.
Number of Owners
Identifies the number of owners (including current) and the last sold date.
Accurate Technical Data
Detailed technical data including Engine Number, Power Outputs and Weight.
Tax Logic & CO2
Identifies the logic applied for yearly tax calculation, and the applicable CO2 value.
Sample Response
V1
Documentation
Introduction
VRM Lookup for Ireland including technical data and NCT due date
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/vehicleidentity?vehicle_registration_mark=A171XX3
Example Sandbox Request
https://sandbox.oneautoapi.com/cartell/vehicleidentity?vehicle_registration_mark=A171XX3
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. A171XX3
Vehicle registration number (VRM).
Sample Response
{
"success": true,
"result": {
"vehicle_registration_mark": "171XX3",
"manufacturer_desc": "NISSAN",
"model_desc": "LEAF",
"derivative_desc": "E TEKNA 5DR AUTO",
"body_type_desc": "HATCHBACK",
"first_registration_date": "2017-01-27",
"first_registration_ireland_date": "2020-01-01",
"fuel_type_desc": "ELECTRIC",
"engine_number": "082479Z",
"engine_capacity_cc": 0,
"vehicle_identification_number": "ABCDE123456F78910",
"transmission_desc": "Automatic",
"power_bhp": 109,
"power_kw": 81,
"power_desc": "109BHP",
"colour": "RED",
"co2_gkm": 0,
"number_doors": 5,
"number_gears": 1,
"manufactured_year": 2017,
"gross_vehicleweight_kg": 1945,
"number_seats": 5,
"drivetrain_desc": "FWD",
"min_kerbweight_kg": 1512,
"number_windows": 4,
"is_exported": false,
"exported_date": "2020-01-01",
"is_imported": true,
"imported_date": "2020-01-01",
"drive_side": "RHD",
"vehicle_tax_type": "PRIVATE vehicle taxed on CO2 (NEDC)",
"last_sold_date": "2024-06-07",
"nct_due_date": "2025-01-01",
"country_of_origin": "Germany",
"number_owners": 2,
"vehicle_category": "B"
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
vehicle_registration_mark
e.g. 171XX3
Vehicle registration number (VRM).
manufacturer_desc
e.g. NISSAN
Manufacturer description
model_desc
e.g. LEAF
Model description.
derivative_desc
e.g. E TEKNA 5DR AUTO
Derivative description.
body_type_desc
e.g. HATCHBACK
The body type description
first_registration_date
e.g. 2017-01-27
Date of first registration.
first_registration_ireland_date
e.g. 2020-01-01
The date the vehicle was first registered in Ireland.
fuel_type_desc
e.g. ELECTRIC
The vehicle's fuel type description
engine_number
e.g. 082479Z
Vehicle engine number.
engine_capacity_cc
e.g. 0
Cubic capacity of the engine.
vehicle_identification_number
e.g. ABCDE123456F78910
Vehicle identification number (VIN).
transmission_desc
e.g. Automatic
The vehicle's transmission type
power_bhp
e.g. 109
Maximum BHP (Brake Horse Power) of this vehicle.
power_kw
e.g. 81
The maximum net power in kw
power_desc
e.g. 109BHP
Describes the power output of the vehicle.
colour
e.g. RED
Exterior colour of vehicle.
co2_gkm
e.g. 0
CO2 in g/km
number_doors
e.g. 5
Number of doors.
number_gears
e.g. 1
Number of gears.
manufactured_year
e.g. 2017
Year of manufacture.
gross_vehicleweight_kg
e.g. 1945
Total weight of the vehicle including the Kerb Weight and Payload Weight in kilograms.
number_seats
e.g. 5
Number of seats.
drivetrain_desc
e.g. FWD
Drivetrain
min_kerbweight_kg
e.g. 1512
Weight of the vehicle, including a full tank of fuel and all standard equipment in kilograms.
number_windows
e.g. 4
The number of windows.
is_exported
e.g. false
Vehicle is 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
drive_side
e.g. RHD
Indicates whether the vehicle is left or right hand drive.
vehicle_tax_type
e.g. PRIVATE vehicle taxed on CO2 (NEDC)
The logic used to determine annual vehicle tax.
last_sold_date
e.g. 2024-06-07
The date on which the vehicle was last sold.
nct_due_date
e.g. 2025-01-01
The date on which the NCT test is due.
country_of_origin
e.g. Germany
Where the vehicle was made and manufactured.
number_owners
e.g. 2
The number of owners, including the current owner including garages.
vehicle_category
e.g. B
The vehicle category in Ireland
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
