RC Lite

Endpoint Overview

POST /api/v1/rc/rc-lite

Description

The RC Lite API provides essential information about registered vehicles in India. This streamlined endpoint delivers key vehicle details including owner information, registration data, vehicle specifications, and current status. It serves as a simplified version of the comprehensive RC information API, designed for quick reference and verification purposes.

Key Benefits

Quick Vehicle Verification: Instantly verify vehicle registration status and ownership details

Comprehensive Vehicle Data: Access essential specifications, registration dates, and compliance information

Compliance Monitoring: Check vehicle fitness, pollution certification, and insurance validity dates

Simplified Integration: Lightweight response structure optimized for common vehicle verification use cases

Use Cases

Automotive

Insurance

Finance

Verify vehicle details during pre-owned vehicle purchases

Validate vehicle specifications for service centers and repair shops

Confirm vehicle legitimacy for automotive marketplaces and classifieds

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_JWT_TOKEN`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	The vehicle's RC (Registration Certificate) number

Example Request

{
    "id_number": "UP61AX8739"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all vehicle registration details
data.client_id	String	Unique identifier for the API request
data.rc_number	String	Vehicle RC (Registration Certificate) number
data.registration_date	String	Date when the vehicle was registered (YYYY-MM-DD format)
data.owner_name	String	Name of the vehicle owner
data.owner_number	String	Contact number of the vehicle owner (may be null)
data.vehicle_class	String	Classification of the vehicle (may be null)
data.vehicle_category	String	Category code of the vehicle (e.g., "2WN")
data.vehicle_category_description	String	Description of the vehicle category (e.g., "M-Cycle/Scooter")
data.vehicle_chasi_number	String	Chassis number of the vehicle
data.vehicle_engine_number	String	Engine number of the vehicle (may be null)
data.maker_model	String	Model name of the vehicle
data.maker_description	String	Additional description of the vehicle model
data.body_type	String	Type of vehicle body
data.fuel_type	String	Type of fuel used by the vehicle
data.color	String	Color of the vehicle (may be null)
data.financed	String	Indicates if the vehicle is financed (may be null)
data.norms_type	String	Emission standards compliance (e.g., "BHARAT STAGE VI")
data.fit_up_to	String	Vehicle fitness validity date (YYYY-MM-DD format)
data.pucc_upto	String	Pollution Under Control Certificate validity date (YYYY-MM-DD format)
data.insurance_upto	String	Vehicle insurance validity date (YYYY-MM-DD format)
data.unladen_weight	String	Weight of the empty vehicle
data.vehicle_gross_weight	String	Gross weight of the vehicle
data.rc_status	String	Current status of the RC (e.g., "ACTIVE")
data.blacklist_status	String	Blacklist status of the vehicle
data.permit_number	String	Vehicle permit number (may be null)
data.permit_issue_date	String	Date when the permit was issued (YYYY-MM-DD format, may be null)
data.permit_valid_from	String	Permit validity start date (YYYY-MM-DD format, may be null)
data.national_permit_number	String	National permit number (may be null)
data.national_permit_upto	String	National permit validity date (YYYY-MM-DD format, may be null)
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API request was successful
message	String	Additional message (may be null)
message_code	String	Code indicating the status of the request

Example Successful Response

{
    "data": {
        "client_id": "rc_lite_aCiwsBcwCIbVeRyfwaNp",
        "rc_number": "AB12CD3456",
        "registration_date": "2099-00-08",
        "owner_name": "MUNNA BHAIYA",
        "owner_number": null,
        "vehicle_class": null,
        "vehicle_category": "2WN",
        "vehicle_category_description": "M-Cycle/Scooter",
        "vehicle_chasi_number": "ABCD3F1LK7XXXXX",
        "vehicle_engine_number": null,
        "maker_model": "BULLET 350 EFI",
        "maker_description": "",
        "body_type": "",
        "fuel_type": "PETROL",
        "color": null,
        "financed": null,
        "norms_type": "BHARAT STAGE VI",
        "fit_up_to": "2099-00-07",
        "pucc_upto": "1800-01-01",
        "insurance_upto": "2099-10-07",
        "unladen_weight": "186",
        "vehicle_gross_weight": "350",
        "rc_status": "ACTIVE",
        "blacklist_status": "NA",
        "permit_number": null,
        "permit_issue_date": null,
        "permit_valid_from": null,
        "national_permit_number": null,
        "national_permit_upto": null
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid RC Number

Authentication Error

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

The provided RC number format is invalid or does not conform to the expected pattern.

Integration Best Practices

Security Recommendations

Store JWT tokens 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 token rotation and refresh mechanisms for production environments

User Experience Guidelines

Implement caching for frequently accessed vehicle data to improve response times

Display vehicle status information prominently to highlight compliance issues

Format dates in a user-friendly manner (e.g., "Oct 7, 2023" instead of "2023-10-07")

Provide clear error messages to end-users when vehicle verification fails

Code Samples

cURL

Python

Node.js

Related APIs

RC Information API: Comprehensive vehicle registration details with extended information

Vehicle History API: Complete history of a vehicle including ownership changes and accidents

Challan Verification API: Check for any pending challans or traffic violations against a vehicle

Compliance and Legal Considerations

This API provides access to vehicle registration data which may be considered personal information under India's data protection regulations. Ensure you have appropriate consent or legal basis for accessing this information. The data should only be used for legitimate business purposes such as vehicle verification, insurance processing, or loan approval. Storing this data beyond the immediate use case may require additional compliance measures.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/rc/rc-lite' \ --header 'Authorization: Bearer TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "UP61AX8739" }'

{ "data": { "client_id": "rc_lite_aCiwsBcwCIbVeRyfwaNp", "rc_number": "AB12CD3456", "registration_date": "2099-00-08", "owner_name": "MUNNA BHAIYA", "owner_number": null, "vehicle_class": null, "vehicle_category": "2WN", "vehicle_category_description": "M-Cycle/Scooter", "vehicle_chasi_number": "ABCD3F1LK7XXXXX", "vehicle_engine_number": null, "maker_model": "BULLET 350 EFI", "maker_description": "", "body_type": "", "fuel_type": "PETROL", "color": null, "financed": null, "norms_type": "BHARAT STAGE VI", "fit_up_to": "2099-00-07", "pucc_upto": "1800-01-01", "insurance_upto": "2099-10-07", "unladen_weight": "186", "vehicle_gross_weight": "350", "rc_status": "ACTIVE", "blacklist_status": "NA", "permit_number": null, "permit_issue_date": null, "permit_valid_from": null, "national_permit_number": null, "national_permit_upto": null }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

RC Lite

RC Lite#

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

RC Lite

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples