Vehicle Detailed Search (v3)
This service is used for retrieving the details of vehicle registration and owner details by entering the vehicle registration number
You will need to login before sending the request. You are required to pass the access token received from the login call as the authorization header in the request.
- Vehicle Number is the Mandatory Parameter to be passed. It can be passed in lower or upper case.
Parameter | Description | Required |
vehicleNumber | The vehicle registration number to be searched | Yes |
blacklistCheck | Whether to perform a blacklist check on the vehicle | Optional |
signzyID | An identifier for the user or session | Optional |
splitAddress | Whether to split the address into components | Optional |
Authorization | Authorization token for API access | Yes |
Content-Type | Format of the data being sent | Yes |
PARAMETER NAME | DESCRIPTION | |
regNo | The registration Number of the vehicle number being searched. | |
class | The vehicle class information is shown here. | |
chassis | The chassis number of the registered vehicle is displayed. | |
vehicleManufacturerName | The name of the vehicle manufacturer is shown here. | |
model | Model of the vehicle | |
type | Type of vehicle (petrol/disel/electric etc) | |
normsType | Type of norms | |
bodyType | Type of the body | |
ownerCount | Number of owner of the vehicle | |
owner | Name of the owner | |
ownerFatherName | The father name of the vehicle owner is displayed here. | |
mobileNumber | Mobile number of the vehicle owner | |
status | Status of the ownership | |
statusASOn | Status last checked date | |
regAuthority | The registration authority of the vehicle registration is displayed in this parameter. | |
regDate | The registration date of the vehicle number being searched. | |
vehicleManufacturingMonthYear | The month and year of manufacturing for the particular vehicle. | |
rcExpiryDate | The date of expiry for the vehicle registration. | |
vehicleTaxUpto | The date upto which the vehicle tax information is paid/valid. | |
vehicleInsuranceCompanyName | This parameter holds the name and details of the company which has carried out the insurance for the registered vehicle | |
vehicleInsuranceUpto | The date upto which the vehicle registration is valid. | |
vehicleInsurancePolicyNumber | The policy number of the vehicle insurance for the vehicle being searched. | |
rcFinancer | The financer information for the registration is available here. | |
presentAddress | The present address of the vehicle owner is displayed here. | |
splitPresentAddress | This parameter displays the various parts of the present address to which the vehicle is registered by splitting them into separate categories like district, state, city, pincode and country. For the country category, acceptable values is “IN”,”IND”and”INDIA” | |
splitPresentAddress.addressLine | first line of address shown here | |
permanentAddress | The permanent address to which the vehicle is registered. | |
splitPermanentAddress | This parameter displays the various parts of the permanent address to which the vehicle is registered by splitting them into separate categories like district, state, city, pincode and country. For the country category, acceptable values is “IN”,”IND”and”INDIA” | |
splitPermanentAddress.addressLine | First line of address | |
vehicleCubicCapacity | The vehicle cubic capacity and dimension details are displayed here. | |
grossVehicleWeight | The gross vehicle weight of the vehicle that is being searched is shown here. | |
unladenWeight | The weight of the vehicle when not loaded with goods. | |
vehicleCategory | The category to which the vehicle belongs. | |
rcStandardCap | RC standard cap details | |
vehicleCylindersNo | The number of cylinders being used by the vehicle is displayed by this parameter. | |
vehicleSeatCapacity | The seating capacity of the vehicle being searched. | |
vehicleSleeperCapacity | The sleeping capacity of the vehicle being searched. | |
wheelbase | Wheelbase Details.The Wheelbase is the horizontal distance between the centers of the front and rear wheels. | |
vehicleNumber | Registration Number of the vehicle. | |
puccNumber | Pollution Under Control Certificates (PUCC)number of vehicle | |
blacklistStatus | It displays whether vehicle is blacklisted | |
blacklistDetails | Details of the blacklisted vehicle | |
permitIssueDate | Date of issue of the permit | |
permitNumber | Permit Number corresponding to the granted permit | |
permitType | Type of permit | |
permitValidFrom | Date from when permit is valid | |
permitValidUpto | Date upto which permit valid | |
nonUseStatus | It displays status of nonuse | |
nonUseFrom | Date from which it is not being used. | |
nonUseTo | Date till which it is not in use | |
nationalPermitNumber | National permit number | |
nationalPermitUpto | National Permit validity date | |
nationalPermitIssuedBy | National permit Issueing organization name | |
isCommercial | It shows whether vehicle is commercial | |
nocDetails | It shows the NOC Details of the vehicle number entered | |
CODE | MESSAGE |
404 | Vehicle data not found |
400 | Invalid vehicle number |
406 | Vehicle record found in more than one office |
409 | Error in fetching data from upstream |
Most of the enterprises maintain a master mapping file which they create and maintain over years for all the possible vehicles. It is used extensively in their system on a day-to-day basis. All of the vehicles have 3 things - the manufacturer of a vehicle, the model name of the vehicle and there are different variants of a particular model from a vehicle manufacturer. The prices for the vehicles vary on the variant level and so does the insurance. Hence, MMV mapping is maintained by most of the enterprise customers to define the pricing and other things based on a unique ID, which is sometimes called as variant ID.
In order to use the MMV mapping feature, please follow the below steps:
Share the MMV mapping master file that you would be maintaining at your end with the Signzy's team. A sample MMV file is attached here for your quick reference.
There are 8 columns in the attached file. Please find the description of each of the columns in the below table.
Column Name | Mandatory/Optional | Description | Example |
make | Mandatory | Manufacturer of the Vehicle | AUDI |
model | Mandatory | Model of the Vehicle | A3 |
variant | Mandatory | Variant of the Vehicle | 35 TDI PREMIUM 143 HP |
seatingcapacity | Optional | Seating Capacity of the Vehicle | 5 |
ccrange | Optional | Cubic Capacity Range - The range of the power output from the engine | > 1500 cc |
cc | Optional | Cubic Capacity - The power output from the engine | 1968 |
fueltype | Optional | Type of the fuel | Diesel |
variantid | Optional | Variant ID for the particular combination of make, model and variant | 8174897 |
Your file can have more columns also. For example, colour of the vehicle and so on. But, there are 3 columns which are mandatory and definitely needs to be present in the MMV master mapping file. Those are - make, model and variant. Your file can have different column names. It doesn't matter. You can share the file with us which you maintain at your end.
Configuration of the MMV master mapping file shared by you at Signzy's end.
Post sharing of the MMV master mapping file, we would be doing the configuration at our end and generating a SIGNZY ID ("signzyID") corresponding to the MMV master mapping file that you have shared with us. Signzy's Team will assign you with the signzyID which needs to be passed in signzyID parameter of the request eg. "SMPSZY"
Once you have received the Signzy ID from us, it completes the MMV mapping and you can use the MMV feature by passing the Signzy ID provided from our side in the API calls you would be doing. For example, if your Signzy ID is "ABCSZY", you would make an API call by passing this Signzy ID and your API request would look like below -
Once you are making an API call by passing Signzy ID, you will get the variants ID and the score in API output. A sample would like look below -
The output will give you a maximum of 5 variant ID alongwith the score of each of these IDs.
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected].