Imagin8 API Specification
Integration for Real time Intelligence

VIN or Reg Search

API Specification


Unless specified as Optional, all parameters are mandatory
API Suite: VIN/Reg
Purpose: Returns VIN, Registration Number, Engine Number, Licene Expiry month and Vehicle Description based on input of either a Registration Number or a VIN number
Web Service: rti_vehicleEnquiry.php
Root URL: Live https://imagin8.co.za/webservices/RTI/vehicle/
Root URL: Sandbox https://imagin8.co.za/webservices/RTI/vehicle/
Parameters Parameter Name Parameter Description
uname The Imagin8 Username
password The Imagin8 Password
clientRef The Customer ID provided by Imagin8
appName The application name, verified by Imagin8
lookupTypeType of lookup to be performed. use "vin" if passing a VIN as the search key, or "reg" if using a registration number as the search key.
vinNoRequired if "vin" is used as the search key. Provide the VIN number to be searched.
regNoRequired if "reg" is used as the lookupType. Provide the Registration Number (with no spaces) to be searched.
Call Example

Search for a vehicle by VIN:

https://imagin8.co.za/webservices/RTI/vehicle/rti_vehicleEnquiry.php?lookupType=vin&vinNo=YXXYY123456007999&uname=YourUserName&password=YourPassword&clientRef=1234&AppName=YourAppName

Search for a vehicle by Registration Number:

https://imagin8.co.za/webservices/RTI/vehicle/rti_vehicleEnquiry.php?lookupType=reg®No=AB12CDGP&uname=YourUserName&password=YourPassword&clientRef=1234&AppName=YourAppName

Return Values The VIN, Registration Number, Engine Number, License Number (from DMV), and license expiry month is returned
Return Values Example {"result":1,"response":{"vehicle":{"LicNo":"DXY999MP","RegNo":"AB12CDGP","VIN":"YXXYY123456007999","EngineNo":"B12345678901","make":"ALFA","model":"MITO"}}}