Chassis To RC

Endpoint Overview

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

Description

This API enables you to retrieve a vehicle's Registration Certificate (RC) number by providing the chassis number and engine number. It serves as a reliable method to verify vehicle identity and ownership details without requiring the registration number upfront. This endpoint is particularly useful for vehicle verification processes, insurance applications, and automotive service providers who need to validate vehicle information based on chassis and engine numbers.

Key Benefits

Quickly retrieve RC numbers using only chassis and engine numbers

Verify vehicle identity with official government records

Reduce manual data entry errors in vehicle verification processes

Streamline vehicle-related workflows with accurate information

Use Cases

Insurance

Automotive

Finance

Verify vehicle details during insurance policy issuance

Validate chassis and engine numbers during claim processing

Automate vehicle information retrieval during policy renewals

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	Bearer token for authentication (JWT format)
Content-Type	Yes	Application/json

Request Body

Parameter	Type	Required	Description
chassis_number	String	Yes	The vehicle's chassis number (e.g., "ME3U3K5F1LK712345")
engine_number	String	Yes	The vehicle's engine number (e.g., "U3K5F1LK312345")

Example Request

{
    "chassis_number": "ME3U3K5F1LK712345",
    "engine_number": "U3K5F1LK312345"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.client_id	String	Unique identifier for the API request
data.rc_number	String	Vehicle Registration Number associated with the provided chassis and engine numbers
data.vehicle_chasi_number	String	The chassis number of the vehicle (as provided in the request)
data.vehicle_engine_number	String	The engine number of the vehicle (as provided in the request)
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the API call was successful
message	String	Human-readable message describing the result
message_code	String	Machine-readable code representing the result

Example Successful Response

{
    "data": {
        "client_id": "chassis_engine_to_rc_bLuqoYoFqUsrjkUizeHa",
        "rc_number": "RJ14XJ1234",
        "vehicle_chasi_number": "ME3U3K5F1LK712345",
        "vehicle_engine_number": "U3K5F1LK312345"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Credentials

Invalid Input

{
    "error": null,
    "message": "Your token is invalid. Please ensure that correct token is being used.",
    "status_code": 401,
    "success": false,
    "message_code": "invalid_token"
}

Authentication failed due to invalid or expired JWT token.

Integration Best Practices

Security Recommendations

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

Implement proper error handling to prevent information leakage

Rotate JWT tokens periodically and implement token expiration

Use HTTPS for all API communications to ensure data encryption in transit

User Experience Guidelines

Implement input validation to ensure chassis and engine numbers follow the correct format

Display clear error messages to users when vehicle information cannot be found

Implement caching strategies to improve response times for frequently queried vehicles

Provide a fallback mechanism for manual entry when automated lookup fails

Code Samples

cURL

Python

Node.js

Related APIs

RC Details by Registration Number - Retrieve comprehensive vehicle details using a registration number

RC Details by DL Number - Fetch vehicle registration details associated with a driving license

Vehicle Ownership Transfer Status - Check the status of vehicle ownership transfers

Compliance and Legal Considerations

This API accesses government vehicle registration data and must be used in compliance with local transportation and data protection regulations. Usage of this API should be limited to legitimate business purposes with proper user consent where required. The data retrieved should be handled according to data privacy regulations and should not be stored longer than necessary for the intended purpose.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/rc/chassis-engine-to-rc' \ --header 'Content-Type: application/json' \ --data-raw '{ "chassis_number": "ME3U3K5F1LK712345", "engine_number": "U3K5F1LK312345" }'

{ "data": { "client_id": "chassis_engine_to_rc_bLuqoYoFqUsrjkUizeHa", "rc_number": "RJ14XJ1234", "vehicle_chasi_number": "ME3U3K5F1LK712345", "vehicle_engine_number": "U3K5F1LK312345" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Chassis To RC

Chassis To RC#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Chassis To RC

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples