Vehicle Detailed Search (v3)

Introduction

This service is used for retrieving the details of vehicle registration and owner details by entering the vehicle registration number

How to call the API

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.

API Input Guidelines

Vehicle Number is the Mandatory Parameter to be passed. It can be passed in lower or upper case.

Sample Curl

curl --location 'https://api-preproduction.signzy.app/api/v3/vehicle/detailedsearches' \
--header 'Authorization: <Auth Token>' \
--header 'Content-Type: application/json' \
--data '{
    "vehicleNumber": "<Vehicle Number>",
    "blacklistCheck": "<true/false>",
    "signzyID": "<ID>",
    "splitAddress": <true/false>
}'

Input Parameters

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

Sample Response

{
    "result": {
        "regNo": " ",
        "class": "Motor Car(LMV)",
        "chassis": " ",
        "engine": " ",
        "vehicleManufacturerName": " ",
        "model": "MARUTI  ESTEEM",
        "vehicleColour": "S WHITE",
        "type": "PETROL",
        "normsType": "Not Available",
        "bodyType": "SALOON",
        "ownerCount": "2",
        "owner": " ",
        "ownerFatherName": " ",
        "mobileNumber": "",
        "status": "ACTIVE",
        "statusAsOn": "03/11/2021",
        "regAuthority": " ",
        "regDate": "20/06/2002",
        "vehicleManufacturingMonthYear": "06/2002",
        "rcExpiryDate": "20/06/2022",
        "vehicleTaxUpto": "31/12/2099",
        "vehicleInsuranceCompanyName": " ",
        "vehicleInsuranceUpto": "30/11/2017",
        "vehicleInsurancePolicyNumber": " ",
        "rcFinancer": "NA",
        "presentAddress": " ",
        "splitPresentAddress": {
            "district": [
                "PUNE"
            ],
            "state": [
                [
                    "MAHARASHTRA",
                    "MH"
                ]
            ],
            "city": [
                "MURKUTENAGAR (N.V.)"
            ],
            "pincode": " ",
            "country": [
                "IN",
                "IND",
                "INDIA"
            ],
             "addressLine": " "
        },
        "permanentAddress": " ",
        "splitPermanentAddress": {
            "district": [
                "PUNE"
            ],
            "state": [
                [
                    "MAHARASHTRA",
                    "MH"
                ]
            ],
            "city": [
                "MURKUTENAGAR (N.V.)"
            ],
            "pincode": "411045",
            "country": [
                "IN",
                "IND",
                "INDIA"
            ],
            "addressLine": " "
        },
        "vehicleCubicCapacity": "1300.0",
        "grossVehicleWeight": "0",
        "unladenWeight": "875",
        "vehicleCategory": "LMV",
        "rcStandardCap": "NA",
        "vehicleCylindersNo": "4",
        "vehicleSeatCapacity": "5",
        "vehicleSleeperCapacity": "NA",
        "vehicleStandingCapacity": "NA",
        "wheelbase": "NA",
        "vehicleNumber": " ",
        "puccNumber": "NA",
        "puccUpto": "NA",
        "blacklistStatus": "NA",
        "blacklistDetails": [],
        "challanDetails": [],
        "permitIssueDate": "NA",
        "permitNumber": "",
        "permitType": "",
        "permitValidFrom": "NA",
        "permitValidUpto": "NA",
        "nonUseStatus": "",
        "nonUseFrom": "NA",
        "nonUseTo": "NA",
        "nationalPermitNumber": "",
        "nationalPermitUpto": "NA",
        "nationalPermitIssuedBy": "",
        "isCommercial": false,
        "nocDetails": "NA",
        "rtoCode": "KA01"
    }
}

Response Parameters

PARAMETER NAME	REQUIRED/OPTIONAL	DATA TYPE	DESCRIPTION
regNo	Yes	string	The registration Number of the vehicle number being searched.
class	Yes	string	The vehicle class information is shown here.
chassis	Yes	string	The chassis number of the registered vehicle is displayed.
engine	Yes	string	The engine number of the registered vehicle is displayed.
vehicleManufacturerName	Yes	string	The name of the vehicle manufacturer is shown here.
model	Yes	string	Model of the vehicle
type	Yes	string	Type of vehicle (petrol/disel/electric etc)
vehicleColour	Yes	string	Color of the vehicle
normsType	Yes	string	Type of norms
bodyType	Yes	string	Type of the body
ownerCount	Yes	string	Number of owner of the vehicle
owner	Yes	string	Name of the owner
ownerFatherName	Yes	string	The father name of the vehicle owner is displayed here.
mobileNumber	No	string	Mobile number of the vehicle owner. It's not available from the source. Deprecated Property - not to be consumed
status	Yes	string	Status of the ownership
statusASOn	Yes	string	Status last checked date
regAuthority	Yes	string	The registration authority of the vehicle registration is displayed in this parameter.
regDate	Yes	string	The registration date of the vehicle number being searched.
vehicleManufacturingMonthYear	Yes	string	The month and year of manufacturing for the particular vehicle.
rcExpiryDate	Yes	string	The date of expiry (Fitness) of the vehicle registration.
vehicleTaxUpto	Yes	string	The date upto which the vehicle tax information is paid/valid.
vehicleInsuranceCompanyName	No	string	This parameter holds the name and details of the company which has carried out the insurance for the registered vehicle
vehicleInsuranceUpto	No	string	The date upto which the vehicle registration is valid.
vehicleInsurancePolicyNumber	No	string	The policy number of the vehicle insurance for the vehicle being searched.
rcFinancer	No	string	The financer information for the registration is available here.
presentAddress	Yes	string	The present address of the vehicle owner is displayed here.
splitPresentAddress	No	object	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	No	string	first line of address shown here
permanentAddress	Yes	string	The permanent address to which the vehicle is registered.
splitPermanentAddress	No	object	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	No	string	First line of address
vehicleCubicCapacity	Yes	string	The vehicle cubic capacity and dimension details are displayed here.
grossVehicleWeight	Yes	string	The gross vehicle weight of the vehicle that is being searched is shown here.
unladenWeight	Yes	string	The weight of the vehicle when not loaded with goods.
vehicleCategory	No	string	The category to which the vehicle belongs.
rcStandardCap	No	string	RC standard cap details
vehicleCylindersNo	No	string	The number of cylinders being used by the vehicle is displayed by this parameter.
vehicleSeatCapacity	No	string	The seating capacity of the vehicle being searched.
vehicleSleeperCapacity	No	string	The sleeping capacity of the vehicle being searched.
vehicleStandingCapacity	No	string	The standing capacity of the vehicle being searched.
wheelbase	No	string	Wheelbase Details.The Wheelbase is the horizontal distance between the centers of the front and rear wheels.
puccNumber	No	string	Pollution Under Control Certificates (PUCC) number of vehicle
puccUpto	No	string	Pollution Under Control Certificates (PUCC) expiry of vehicle
blacklistStatus	No	string	It displays the blacklist details of the vehicle for e.g. Locked by TRANSPORT NAGAR RTO Bangalore (KA32),Karnataka due to reason Others, OWNER VISHWA DEEPAK DWIVEDI dated 02-May-2022
blacklistDetails	No	object	Details of the blacklisted vehicle Deprecated object - not to be consumed
challanDetails	No	string	Challan details of the vehicle Not to be consumed. Challan Details are now handled as part of the separate APIs. Please check Challan Advanced Details Search (with Challan Images) Challan Search
permitIssueDate	No	string	Date of issue of the permit
permitNumber	No	string	Permit Number corresponding to the granted permit
permitType	No	string	Type of permit
permitValidFrom	No	string	Date from when permit is valid
permitValidUpto	No	string	Date upto which permit valid
nonUseStatus	No	string	It displays status of nonuse
nonUseFrom	No	string	Date from which it is not being used.
nonUseTo	No	string	Date till which it is not in use
nationalPermitNumber	No	string	National permit number
nationalPermitUpto	No	string	National Permit validity date
nationalPermitIssuedBy	No	string	National permit Issueing organization name
isCommercial	Yes	boolean	It shows whether vehicle is commercial
nocDetails	No	string	It shows the NOC Details of the vehicle number entered
mappings	No	object	Mapping object containing variantIds

Status Codes

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

MMV (Make, Model & Variant) Mapping

What is MMV Mapping?

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.

What are the steps to get MMV Mapping configured at Signzy's end?

In order to use the MMV mapping feature, please follow the below steps:

Step 1

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.

Step 2

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"

Step 3

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 -

What will be the output of MMV Mapping?

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 -

"variantIds": [
                {
                    "variantId": "20000962",
                    "score": 1
                },
                {
                    "variantId": "20001002",
                    "score": 0.9
                },
                {
                    "variantId": "20001005",
                    "score": 0.79
                },
                {
                    "variantId": "20001001",
                    "score": 0.75
                },
                {
                    "variantId": "20001003",
                    "score": 0.71
                }
            ]

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].