RC Historical Async API

Overview

The RC historical Async API would provide the historical details about an API

The API has two main endpoints.

api/v3/vehicle-service/rc-historical-data-async : The API takes vehicle registration number , phone number and a callback url as input and provides the request ID as output. This API pushes output to the callback url through which data can be retrived.
api/v3/vehicle-service/rc-historical-get-data : This API takes request ID & OTP received in provided phone number generated by historcial async API to generate the response for the requested vehicle.

API Description

The API has two endpoints as described above these APIs provide the details of vehicle taking the vehicle number and callback URL.

Historical Async API, Initiate Request

Sample cURL

curl --location 'https://api.signzy.app/api/v3/vehicle-service/rc-historical-data-async' \
--header 'Authorization: <auth token>' \
--header 'Content-Type: application/json' \
--data '{
    "regNo": "KA51AC1010",
    "phoneNumber": "9988776655",
    "callBackUrl": "https://webhook.site/7e252366-e149-4f31-9950-1a990c6cdf56"
}'

Input Description Table

Paramter	Required	Data Type	Description
Authorization	Yes	String	Authentication token for accessing the API
Content-Type	Yes	String	Specifies the media type of the resource (application/json)
regNo	Yes	String	Registration number of the vehicle
phoneNumber	Yes	String	Phone number registered with the vehicle number
callBackUrl	Yes	String	URL to which the response should be sent once the process is complete

Sample Output

{
    "result": {
        "requestId": "66461d48c816e2ff210a870e",
        "statusCode": 102,
        "status": "PROCESSING"
    }
}

Sample Output Table

Output Parameter	Data Type	Description
result	Object	Parent object containing the response details
requestId	String	Unique identifier for the request
statusCode	Number	Status code indicating the current status of the request
status	String	Status message describing the current state of the request

Historical get data API

Sample cURL

curl --location 'https://api-preproduction.signzy.app/api/v3/vehicle-service/rc-historical-get-data' \
--header 'Authorization: <auth key>' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "6645d9afc816e2ff210a86f9",
    "otp": "XXXX"
}'

Input Description

Paramter	Required	Data Type	Description
Authorization	Yes	String	Authentication token for accessing the API
Content-Type	Yes	String	Specifies the media type of the resource (application/json)
requestId	Yes	String	Unique identifier for the request
otp	Yes	String	OTP received with the provided phone number

Sample Output

{
    "result": {
        "requestId": "6645d9afc816e2ff210a86f9",
        "input": {
            "regNo": "KA51AC1010",
            "callBackUrl": "https://webhook.site/7e252366-e149-4f31-9950-1a990c6cdf56"
        },
        "status": "Success",
        "statusCode": 200,
        "message": "CLIENT ERROR",
        "response": {
            "dispatchRCDetails": [],
            "ownerDetails": {
                "ownerName": "ADITI MANGESH DALVI",
                "fathersHusbandsName": "MANGESH SATHISH DALVI",
                "address": "# 1E-803, DIVYASHREE ELAN, OPP,TOTAL MALL, SARJAPURA MAIN ROAD,,BANGALORE SOUTH,,Karnataka,560035",
                "ownerSerialNo": "1"
            },
            "vehicleDetails": {
                "registeredWithRto": "ELECTRONIC CITY  RTO,",
                "vehicleStatus": "ACTIVE",
                "vehicleClass": "M-Cycle/Scooter",
                "chasisNo": "MB8DP11AHJ8979452",
                "horsePower": "",
                "color": "WHITE",
                "engineNo": "AF211772891",
                "bodyType": "SOLO",
                "makerModel": "ACCESS 125",
                "fuel": "PETROL",
                "seatingCapacity": "2",
                "standingCapacity": "",
                "unladenWeightKg": "267",
                "ladenWeightKg": "102"
            },
            "feeCollectionDetails": [
                {
                    "sNo": "1",
                    "receiptNo": "KA51R22040007151",
                    "receiptDate": "19-Apr-2022",
                    "feeAmount": "150",
                    "fine": "0",
                    "feeParticular": "Conversion of Vehicle",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "2",
                    "receiptNo": "KA51R22040007151",
                    "receiptDate": "19-Apr-2022",
                    "feeAmount": "200",
                    "fine": "0",
                    "feeParticular": "Registration Certificate fees",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "3",
                    "receiptNo": "KA51R22040007151",
                    "receiptDate": "19-Apr-2022",
                    "feeAmount": "200",
                    "fine": "0",
                    "feeParticular": "Hypothecation Termination",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "4",
                    "receiptNo": "KA210108C6774575",
                    "receiptDate": "08-Jan-2021",
                    "feeAmount": "400",
                    "fine": "0",
                    "feeParticular": "Fitness Inspection/Certificate",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "5",
                    "receiptNo": "CP3452700",
                    "receiptDate": "07-Sep-2018",
                    "feeAmount": "100",
                    "fine": "0",
                    "feeParticular": "Permit Variation/Endorcement",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "6",
                    "receiptNo": "CP3452700",
                    "receiptDate": "07-Sep-2018",
                    "feeAmount": "400",
                    "fine": "0",
                    "feeParticular": "Fresh Permit",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "7",
                    "receiptNo": "CP3452047",
                    "receiptDate": "01-Sep-2018",
                    "feeAmount": "400",
                    "fine": "0",
                    "feeParticular": "Fitness Inspection/Certificate",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "8",
                    "receiptNo": "CP3452046",
                    "receiptDate": "01-Sep-2018",
                    "feeAmount": "137",
                    "fine": "0",
                    "feeParticular": "Smart Card Fee",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "9",
                    "receiptNo": "CP3452046",
                    "receiptDate": "01-Sep-2018",
                    "feeAmount": "500",
                    "fine": "0",
                    "feeParticular": "Hypothecation Addition",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "10",
                    "receiptNo": "CP3452046",
                    "receiptDate": "01-Sep-2018",
                    "feeAmount": "300",
                    "fine": "700",
                    "feeParticular": "New Registration",
                    "office": "ELECTRONIC CITY  RTO,KA"
                }
            ],
            "allOwnerDetails": [
                {
                    "sNo": "1",
                    "registrationNo": "KA51AC1010",
                    "ownerName": "ADITI MANGESH DALVI",
                    "fatherName": "MANGESH SATHISH DALVI",
                    "address": "# 1E-803, DIVYASHREE ELAN, OPP,TOTAL MALL, SARJAPURA MAIN ROAD,,BANGALORE SOUTH,,Karnataka,560035",
                    "status": "ACTIVE",
                    "movedOn": "",
                    "movedBy": "",
                    "officeName": "ELECTRONIC CITY  RTO"
                }
            ],
            "taxDetails": [
                {
                    "sNo": "1",
                    "receiptNo": "CP3452048",
                    "taxFrom": "01-Sep-2018",
                    "taxUpto": "31-Aug-2033",
                    "taxType": "MV Tax",
                    "challanDate": "01-Sep-2018",
                    "taxAmount": "7486",
                    "finePenalty": "0",
                    "office": "ELECTRONIC CITY  RTO,KA"
                }
            ],
            "insuranceDetails": [
                {
                    "sNo": "1",
                    "insuranceCompany": "NATIONAL INSURANCE CO LTD.",
                    "insuranceType": "COMPREHENSIVE",
                    "insuranceFrom": "30-Aug-2018",
                    "insuranceUpto": "29-Aug-2019",
                    "coverNoteNo": "1234",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "2",
                    "insuranceCompany": "NATIONAL INSURANCE CO LTD.",
                    "insuranceType": "THIRD PARTY",
                    "insuranceFrom": "04-Sep-2021",
                    "insuranceUpto": "03-Sep-2022",
                    "coverNoteNo": "610501312110008449",
                    "office": "ELECTRONIC CITY  RTO,KA"
                }
            ],
            "transferOfOwnershipDetails": [],
            "statusAsOnDate": "14-May-2024",
            "hypothecationDetails": [
                {
                    "sNo": "1",
                    "applicationNo": "KA22041858819661",
                    "hypothecationType": "LA",
                    "financerName": "WICKEDRIDE ADVENTURE SERVICE PVT",
                    "financerAddress": "LTD,. # 1705, 2ND FLR,EAST END",
                    "fromDate": "03-Sep-2018",
                    "toDate": "18-Apr-2022",
                    "terminationDate": "31-May-2022",
                    "office": "ELECTRONIC CITY  RTO,KA"
                }
            ],
            "permitDetails": [
                {
                    "sNo": "1",
                    "applicationNo": "KA51A4913533",
                    "permitNo": "51C-LT-KA/3716/2018-191",
                    "issueDate": "07-Sep-2018",
                    "validFrom": "07-Sep-2018",
                    "validUpto": "06-Sep-2023",
                    "permitType": "Contract Carriage Permit",
                    "permitCategory": "",
                    "office": "ELECTRONIC CITY  RTO"
                }
            ],
            "blacklistDetails": [],
            "fitnessDetails": [
                {
                    "sNo": "1",
                    "applNo": "KA210108V4504799",
                    "fitnessCheckDate": "05-Sep-2018",
                    "result": "Pass",
                    "fitnessUpto": "04-Sep-2020",
                    "nid": "",
                    "operationDate": "05-Sep-2018",
                    "fitnessOfficerName1": "",
                    "fitnessOfficerName2": "",
                    "office": "ELECTRONIC CITY  RTO,KA"
                },
                {
                    "sNo": "2",
                    "applNo": "KA22041858819661",
                    "fitnessCheckDate": "13-Jan-2021",
                    "result": "Pass",
                    "fitnessUpto": "12-Jan-2023",
                    "nid": "14-Dec-2022",
                    "operationDate": "17-Jan-2021",
                    "fitnessOfficerName1": "SUDHAKAR M N",
                    "fitnessOfficerName2": "",
                    "office": "ELECTRONIC CITY  RTO,KA"
                }
            ]
        }
    }
}

Output Table

Parameter	Data Type	Description
status	String	Overall status of the response (e.g., SUCCESS, FAILURE).
statusCode	Integer	HTTP status code of the response.
message	String	Message detailing the response status.
response	Object	Parent object containing detailed vehicle, owner, and transaction information.
response.ownerDetails	Object	Contains information about the vehicle's owner.
response.ownerDetails.ownerName	String	Name of the vehicle owner.
response.ownerDetails.address	String	Residential address of the owner.
response.vehicleDetails	Object	Contains specific details about the vehicle.
response.vehicleDetails.vehicleStatus	String	Current status of the vehicle (e.g., ACTIVE, INACTIVE).
response.vehicleDetails.vehicleClass	String	Class of the vehicle (e.g., Car, Motorcycle).
response.vehicleDetails.chasisNo	String	Chassis number of the vehicle.
response.vehicleDetails.engineNo	String	Engine number of the vehicle.
response.vehicleDetails.makerModel	String	Manufacturer and model of the vehicle.
response.vehicleDetails.fuel	String	Type of fuel used by the vehicle.
response.vehicleDetails.color	String	Color of the vehicle.
response.insuranceDetails	Object	Contains details about the vehicle's insurance.
response.insuranceDetails.insuranceCompany	String	Name of the insurance company.
response.insuranceDetails.insuranceType	String	Type of insurance (e.g., COMPREHENSIVE, THIRD PARTY).
response.insuranceDetails.insuranceFrom	Date	Start date of the current insurance policy.
response.insuranceDetails.insuranceUpto	Date	Expiry date of the insurance policy.
response.insuranceDetails.coverNoteNo	String	Cover note number associated with the insurance.
response.hypothecationDetails	Object	Contains information about any financiers associated with the vehicle.
response.hypothecationDetails.financerName	String	Name of the financer for the vehicle hypothecation.
response.hypothecationDetails.financerAddress	String	Address of the financer.
response.hypothecationDetails.fromDate	Date	Start date of the hypothecation.
response.hypothecationDetails.toDate	Date	End date of the hypothecation (planned).
response.hypothecationDetails.terminationDate	Date	Actual date on which the hypothecation was terminated.
response.permitDetails	Object	Contains details about the vehicle's permit(s).
response.permitDetails.permitNo	String	Permit number issued by the transport office.
response.permitDetails.issueDate	Date	Date on which the permit was issued.
response.permitDetails.validFrom	Date	Start date from which the permit is valid.
response.permitDetails.validUpto	Date	Expiry date of the vehicle's permit.
response.permitDetails.permitType	String	Type of permit (e.g., Contract Carriage Permit).
response.fitnessDetails	Object	Contains details about the vehicle's fitness checks.
response.fitnessDetails.fitnessCheckDate	Date	Most recent date the vehicle underwent a fitness check.
response.fitnessDetails.result	String	Result of the fitness check (e.g., Pass, Fail).
response.fitnessDetails.fitnessUpto	Date	Date until which the vehicle's fitness certification is valid.
response.fitnessDetails.fitnessOfficerName1	String	Name of the first officer who conducted the fitness test.
response.fitnessDetails.fitnessOfficerName2	String	Name of the second officer who conducted the fitness test (if any).
response.taxDetails	Object	Contains details about the vehicle's taxation records.
response.taxDetails.taxFrom	Date	Start date from which the tax period begins.
response.taxDetails.taxUpto	Date	Date until which vehicle tax has been paid.
response.taxDetails.taxType	String	Type of tax applied (e.g., MV Tax).
response.taxDetails.challanDate	Date	Date on which the tax was officially recorded.
response.taxDetails.taxAmount	Integer	Amount of tax paid.
response.taxDetails.finePenalty	Integer	Any fines or penalties applied in addition to the tax.

Error Codes

Status Code	Message	Description
200	Success	Data is retirved Successfully
400	Validation Error	The Input parameter is wrong
409	Upstream Down Error	The server is timing out

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