Chassis To RC Details

Endpoint Overview

POST /api/v1/rc/chassis-to-rc-details

Description

This API retrieves comprehensive vehicle information from the Indian vehicle registration database using a chassis number. It provides detailed data about the vehicle including registration details, owner information, vehicle specifications, insurance status, and more. The API is designed to help verify vehicle ownership, check registration status, and obtain essential information about registered vehicles in India.

Key Benefits

Verify vehicle authenticity and ownership details using just the chassis number

Access comprehensive vehicle specifications including make, model, and technical details

Obtain insurance and permit validity information for compliance verification

Check vehicle registration status and history for due diligence

Use Cases

Automotive Industry

Insurance

Financial Services

Verify vehicle details during pre-owned car purchases

Validate chassis numbers against registration data for fraud prevention

Check vehicle specifications for service and parts compatibility

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	JWT Bearer token for authentication. Format: `Bearer <your_token>`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
chassis_number	String	Yes	The vehicle chassis number to query. Must be a valid chassis number format.

Example Request

{
    "chassis_number": "MALBM51ABC123456"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the response data
data.client_id	String	Unique identifier for the client making the request
data.rc_number	String	Vehicle registration number
data.vehicle_chasi_number	String	Vehicle chassis number
data.details	Object	Comprehensive vehicle details (see table below)
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Additional message (null if successful)
message_code	String	Code indicating the status of the request

Vehicle Details Object

Parameter	Type	Description
rc_number	String	Registration certificate number
fit_up_to	String	Fitness certificate validity date (YYYY-MM-DD)
registration_date	String	Date of vehicle registration (YYYY-MM-DD)
owner_name	String	Name of the vehicle owner
father_name	String	Father's name of the vehicle owner
present_address	String	Current address of the vehicle owner
permanent_address	String	Permanent address of the vehicle owner
mobile_number	String	Mobile number of the vehicle owner
vehicle_category	String	Category of the vehicle (e.g., LMV)
vehicle_chasi_number	String	Chassis number of the vehicle
vehicle_engine_number	String	Engine number of the vehicle
maker_description	String	Description of the vehicle manufacturer
maker_model	String	Model of the vehicle
body_type	String	Type of vehicle body (e.g., HATCHBACK)
fuel_type	String	Type of fuel used by the vehicle
color	String	Color of the vehicle
norms_type	String	Emission norms type (e.g., BHARAT STAGE IV)
financer	String	Name of the financing entity (if applicable)
financed	Boolean	Indicates if the vehicle is financed
insurance_company	String	Name of the insurance company
insurance_policy_number	String	Insurance policy number
insurance_upto	String	Insurance validity date (YYYY-MM-DD)
manufacturing_date	String	Manufacturing date of the vehicle
manufacturing_date_formatted	String	Formatted manufacturing date (YYYY-MM)
registered_at	String	RTO where the vehicle is registered
latest_by	String	Latest information update date (YYYY-MM-DD)
less_info	Boolean	Indicates if limited information is available
tax_upto	String	Tax validity date (YYYY-MM-DD)
tax_paid_upto	String	Tax paid up to date (YYYY-MM-DD)
cubic_capacity	String	Engine cubic capacity
vehicle_gross_weight	String	Gross weight of the vehicle
no_cylinders	String	Number of cylinders in the engine
seat_capacity	String	Seating capacity of the vehicle
sleeper_capacity	String	Sleeper capacity of the vehicle
standing_capacity	String	Standing capacity of the vehicle
wheelbase	String	Wheelbase of the vehicle
unladen_weight	String	Unladen weight of the vehicle
vehicle_category_description	String	Detailed description of vehicle category
pucc_number	String	Pollution Under Control Certificate number
pucc_upto	String	PUC certificate validity date (YYYY-MM-DD)
permit_number	String	Permit number (if applicable)
permit_issue_date	String	Permit issue date (YYYY-MM-DD)
permit_valid_from	String	Permit validity start date (YYYY-MM-DD)
permit_valid_upto	String	Permit validity end date (YYYY-MM-DD)
permit_type	String	Type of permit
national_permit_number	String	National permit number (if applicable)
national_permit_upto	String	National permit validity date (YYYY-MM-DD)
national_permit_issued_by	String	Authority that issued the national permit
non_use_status	String	Non-use status of the vehicle
non_use_from	String	Non-use start date (YYYY-MM-DD)
non_use_to	String	Non-use end date (YYYY-MM-DD)
blacklist_status	String	Blacklist status of the vehicle
noc_details	String	No Objection Certificate details
owner_number	String	Owner sequence number
rc_status	String	Registration certificate status (e.g., ACTIVE)
masked_name	Boolean	Indicates if owner name is masked
challan_details	String	Details of any pending challans
variant	String	Vehicle variant details

Example Successful Response

{
    "data": {
        "client_id": "chassis_to_rc_details_gGDVygwiMPwdRfYbVoyZ",
        "rc_number": "PB00AZ1234",
        "vehicle_chasi_number": "MALBM51ABC123456",
        "details": {
            "rc_number": "PB00AZ1234",
            "fit_up_to": "2034-01-25",
            "registration_date": "2019-01-26",
            "owner_name": "TARSEM SINGH",
            "father_name": "BALVIR SINGH",
            "present_address": "VILLAGE, FIROZPUR,142044",
            "permanent_address": "VILLAGE,CHAK ,FIROZPUR,142044",
            "mobile_number": "",
            "vehicle_category": "LMV",
            "vehicle_chasi_number": "MALBM51ABC123456",
            "vehicle_engine_number": "D4FCJM12345",
            "maker_description": "HYUNDAI MOTOR INDIA LTD",
            "maker_model": "I20 SPORTZ CRDI",
            "body_type": "HATCHBACK",
            "fuel_type": "DIESEL",
            "color": "POLAR WHITE 2",
            "norms_type": "BHARAT STAGE IV",
            "financer": "",
            "financed": false,
            "insurance_company": "HDFC ERGO General Insurance Company Ltd",
            "insurance_policy_number": "230123456000000",
            "insurance_upto": "2025-01-20",
            "manufacturing_date": "10/2018",
            "manufacturing_date_formatted": "2018-10",
            "registered_at": "FEROZPUR RTA, Punjab",
            "latest_by": "2024-01-31",
            "less_info": true,
            "tax_upto": null,
            "tax_paid_upto": "2034-01-25",
            "cubic_capacity": "1396.00",
            "vehicle_gross_weight": "1630",
            "no_cylinders": "4",
            "seat_capacity": "5",
            "sleeper_capacity": "0",
            "standing_capacity": "0",
            "wheelbase": "2570",
            "unladen_weight": "1161",
            "vehicle_category_description": "Motor Car(LMV)",
            "pucc_number": null,
            "pucc_upto": null,
            "permit_number": "",
            "permit_issue_date": null,
            "permit_valid_from": null,
            "permit_valid_upto": null,
            "permit_type": "",
            "national_permit_number": "",
            "national_permit_upto": null,
            "national_permit_issued_by": "",
            "non_use_status": null,
            "non_use_from": null,
            "non_use_to": null,
            "blacklist_status": "",
            "noc_details": "",
            "owner_number": "2",
            "rc_status": "ACTIVE",
            "masked_name": false,
            "challan_details": null,
            "variant": null
        }
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid Chassis Number

Authentication Error

{
    "status_code": 422,
    "success": false,
    "message": "Verification Failed.",
    "message_code": "verification_failed"
}

The chassis number provided is invalid or in an incorrect format.

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption

Implement rate limiting on your end to prevent abuse of the API

User Experience Guidelines

Implement proper validation for chassis number format before making API calls

Display a user-friendly loading state while waiting for API response

Format dates in a user-friendly manner when displaying to end-users

Provide clear error messages that guide users on how to resolve issues

Code Samples

cURL

Python

Node.js

Related APIs

RC Details by Registration Number - Retrieves vehicle details using registration number

RC Details by Engine Number - Retrieves vehicle details using engine number

RC Verification - Verifies vehicle registration details against provided information

RC History - Retrieves historical records of a vehicle registration

Compliance and Legal Considerations

This API accesses official government vehicle registration data. Usage must comply with Indian data protection regulations and the Motor Vehicles Act. The data should only be used for legitimate business purposes with proper consent where required. Storing or caching of personal information must adhere

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/rc/chassis-to-rc-details' \ --header 'Authorization: Bearer TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "chassis_number": "MALBM51ABC123456" }'

{ "data": { "client_id": "chassis_to_rc_details_gGDVygwiMPwdRfYbVoyZ", "rc_number": "PB00AZ1234", "vehicle_chasi_number": "MALBM51ABC123456", "details": { "rc_number": "PB00AZ1234", "fit_up_to": "2034-01-25", "registration_date": "2019-01-26", "owner_name": "TARSEM SINGH", "father_name": "BALVIR SINGH", "present_address": "VILLAGE, FIROZPUR,142044", "permanent_address": "VILLAGE,CHAK ,FIROZPUR,142044", "mobile_number": "", "vehicle_category": "LMV", "vehicle_chasi_number": "MALBM51ABC123456", "vehicle_engine_number": "D4FCJM12345", "maker_description": "HYUNDAI MOTOR INDIA LTD", "maker_model": "I20 SPORTZ CRDI", "body_type": "HATCHBACK", "fuel_type": "DIESEL", "color": "POLAR WHITE 2", "norms_type": "BHARAT STAGE IV", "financer": "", "financed": false, "insurance_company": "HDFC ERGO General Insurance Company Ltd", "insurance_policy_number": "230123456000000", "insurance_upto": "2025-01-20", "manufacturing_date": "10/2018", "manufacturing_date_formatted": "2018-10", "registered_at": "FEROZPUR RTA, Punjab", "latest_by": "2024-01-31", "less_info": true, "tax_upto": null, "tax_paid_upto": "2034-01-25", "cubic_capacity": "1396.00", "vehicle_gross_weight": "1630", "no_cylinders": "4", "seat_capacity": "5", "sleeper_capacity": "0", "standing_capacity": "0", "wheelbase": "2570", "unladen_weight": "1161", "vehicle_category_description": "Motor Car(LMV)", "pucc_number": null, "pucc_upto": null, "permit_number": "", "permit_issue_date": null, "permit_valid_from": null, "permit_valid_upto": null, "permit_type": "", "national_permit_number": "", "national_permit_upto": null, "national_permit_issued_by": "", "non_use_status": null, "non_use_from": null, "non_use_to": null, "blacklist_status": "", "noc_details": "", "owner_number": "2", "rc_status": "ACTIVE", "masked_name": false, "challan_details": null, "variant": null } }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Chassis To RC Details

Chassis To RC Details#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Vehicle Details Object#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Chassis To RC Details

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Vehicle Details Object

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples