RC V2 API

Endpoint Overview

POST /api/v1/rc/rc-v2

Description

The Vehicle Registration Certificate (RC) V2 API provides secure, real-time access to authoritative vehicle registration data across India. Designed for flexibility and privacy, this API allows clients to retrieve comprehensive vehicle details with configurable data masking, ensuring compliance with regulatory requirements while supporting a wide range of business use cases.

The API supports two response modes:

Normal Mode: Sensitive fields (owner name, chassis number, engine number) are masked.

Enriched Mode: Owner name and chassis number are fully disclosed; only the engine number remains masked.

Key Benefits

Access up-to-date, authoritative vehicle registration data from official sources.

Flexible privacy controls with configurable data masking.

Supports both compliance-driven and business-enrichment workflows.

Simple, secure integration with JWT-based authentication.

Use Cases

Automotive & Insurance

Banking & Finance

Mobility & Logistics

Instant vehicle verification during insurance policy issuance or renewal.

Automated claims processing and fraud detection using verified RC data.

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

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

Request Parameters

Request Headers

Header	Required	Description
Content-Type	Yes	Must be `application/json`
Authorization	Yes	Bearer token for authentication (JWT)

Request Body

Parameter	Type	Required	Description
id_number	string	Yes	Vehicle registration number (RC number)
enrich	boolean	No	Set to `true` for Enriched response (owner name & chassis unmasked, engine masked). Defaults to `false` (Normal mode).

Example Request

{
  "id_number": "DL08AB1234",
  "enrich": true
}

Process Response

Response Parameters

Parameter	Type	Description
client_id	string	Unique client ID associated with the request
rc_number	string	Registered vehicle number
fit_up_to	string	Validity date of the fitness certificate
registration_date	string	Vehicle registration date
owner_name	string	Owner name (masked or unmasked based on `enrich`)
father_name	string	Name of the vehicle owner's father
present_address	string	Current address of the owner
permanent_address	string	Permanent address of the owner
mobile_number	string	Mobile number (if available)
vehicle_category	string	Vehicle category
vehicle_chasi_number	string	Chassis number (masked or unmasked based on `enrich`)
vehicle_engine_number	string	Engine number (masked in all modes)
maker_description	string	Manufacturer description
maker_model	string	Model name of the vehicle
body_type	string	Vehicle body type
fuel_type	string	Type of fuel used
color	string	Vehicle color
norms_type	string	Emission norms
financer	string	Name of the financer (if any)
financed	boolean	Indicates if vehicle is financed
insurance_company	string	Insurance provider name
insurance_policy_number	string	Policy number of the insurance
insurance_upto	string	Validity of the insurance policy
manufacturing_date	string	Original manufacture date
manufacturing_date_formatted	string	Formatted manufacture date
registered_at	string	RTO office where vehicle was registered
latest_by	string	Most recent data update timestamp
less_info	boolean	Indicates if information is limited
tax_upto	string	Validity of tax payment
tax_paid_upto	string	Date up to which tax has been paid
cubic_capacity	string	Engine capacity in cc
vehicle_gross_weight	string	Gross weight of vehicle
no_cylinders	string	Number of cylinders
seat_capacity	string	Number of seats
sleeper_capacity	string/null	Sleeper berth capacity
standing_capacity	string/null	Standing capacity
wheelbase	string/null	Distance between front and rear axle
unladen_weight	string	Vehicle weight without load
vehicle_category_description	string	Description of vehicle category
pucc_number	string	Pollution certificate number
pucc_upto	string/null	Validity of Pollution certificate
permit_number	string	Vehicle permit number
permit_issue_date	string/null	Permit issue date
permit_valid_from	string/null	Permit validity start date
permit_valid_upto	string/null	Permit expiry date
permit_type	string	Type of permit
national_permit_number	string	National permit number
national_permit_upto	string/null	National permit expiry
national_permit_issued_by	string/null	Issuing authority of national permit
non_use_status	string/null	Non-use status
non_use_from	string/null	Start date of non-use
non_use_to	string/null	End date of non-use
blacklist_status	string	Vehicle blacklist status
noc_details	string	No Objection Certificate details
owner_number	string	Number of owners so far
rc_status	string/null	Status of registration certificate
rto_code	string/null	RTO code
response_metadata	object	Metadata about masking of sensitive fields

response_metadata (Object)

Parameter	Type	Description
masked_chassis	boolean	Indicates if the `vehicle_chasi_number` field is masked (`true`) or fully visible (`false`)
masked_engine	boolean	Indicates if the `vehicle_engine_number` field is masked (`true`) or fully visible (`false`)
masked_owner_name	boolean	Indicates if the `owner_name` field is masked (`true`) or fully visible (`false`)

Example Successful Response

{
  "data": {
    "client_id": "rc_v2_tzomotgoEEkXGfksyLav",
    "rc_number": "DL08AB1234",
    "fit_up_to": "2032-12-15",
    "registration_date": "2018-01-20",
    "owner_name": "R***N K****R",
    "father_name": "",
    "present_address": "New Delhi, 110034",
    "permanent_address": "New Delhi, 110034",
    "mobile_number": "",
    "vehicle_category": "2WN",
    "vehicle_chasi_number": "ME3XYZAB1JK456789",
    "vehicle_engine_number": "XYZAB1JK0*****",
    "maker_description": "HONDA MOTORCYCLE & SCOOTER INDIA PVT LTD",
    "maker_model": "ACTIVA 5G",
    "body_type": "SCOOTER",
    "fuel_type": "PETROL",
    "color": "BLACK",
    "norms_type": "BS4",
    "financer": "",
    "financed": false,
    "insurance_company": "ICICI Lombard General Insurance Co. Ltd.",
    "insurance_policy_number": "IC1234567890",
    "insurance_upto": "2025-12-20",
    "manufacturing_date": "12/2017",
    "manufacturing_date_formatted": "2017-12",
    "registered_at": "DELHI, Delhi",
    "latest_by": "2025-08-29",
    "less_info": true,
    "tax_upto": "2032-12-15",
    "tax_paid_upto": "2032-12-15",
    "cubic_capacity": "109.19",
    "vehicle_gross_weight": "0",
    "no_cylinders": "1",
    "seat_capacity": "2",
    "sleeper_capacity": null,
    "standing_capacity": null,
    "wheelbase": null,
    "unladen_weight": "109",
    "vehicle_category_description": "Scooter(2WN)",
    "pucc_number": "DL009876543210",
    "pucc_upto": "2025-11-25",
    "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": null,
    "non_use_status": null,
    "non_use_from": null,
    "non_use_to": null,
    "blacklist_status": "",
    "noc_details": "",
    "owner_number": "1",
    "rc_status": null,
    "rto_code": null,
    "response_metadata": {
      "masked_chassis": true,
      "masked_engine": true,
      "masked_owner_name": true
    }
  },
  "status_code": 200,
  "success": true,
  "message": null,
  "message_code": "success"
}

Possible Error Responses

Invalid Token

Vehicle Not Found

Multiple RTO Found

{
  "status_code": 401,
  "success": false,
  "message": "Invalid or expired token",
  "message_code": "auth_error"
}

Authentication failed. Ensure your JWT token is valid and not expired.

Integration Best Practices

Security Recommendations

Always use HTTPS for all API requests to protect sensitive data in transit.

Store JWT tokens securely and rotate them periodically.

Never expose your API keys or tokens in client-side code or public repositories.

User Experience Guidelines

Validate user input before sending requests to avoid unnecessary errors.

Clearly communicate to users when data is masked for privacy reasons.

Handle error responses gracefully and provide actionable feedback to users.

Code Samples

cURL

Python

Node.js

Related APIs

Driving License Verification API: Retrieve and verify driving license details.

Vehicle Challan API: Fetch challan (traffic violation) records for a vehicle.

Vehicle Owner History API: Get historical ownership data for a vehicle.

Compliance and Legal Considerations

Ensure all data usage complies with local privacy laws and regulations. Use the API only for legitimate business purposes and obtain user consent where required. Do not store or display unmasked personal data unless strictly necessary and permitted by law.

This documentation is designed to help you integrate the RC V2 API quickly and securely. For further assistance, refer to the Surepass developer portal or contact support.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/rc/rc-v2' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "DL08AB1234", "enrich": true }'

{ "data": { "client_id": "rc_v2_tzomotgoEEkXGfksyLav", "rc_number": "DL08AB1234", "fit_up_to": "2032-12-15", "registration_date": "2018-01-20", "owner_name": "R***N K****R", "father_name": "", "present_address": "New Delhi, 110034", "permanent_address": "New Delhi, 110034", "mobile_number": "", "vehicle_category": "2WN", "vehicle_chasi_number": "ME3XYZAB1JK456789", "vehicle_engine_number": "XYZAB1JK0*****", "maker_description": "HONDA MOTORCYCLE & SCOOTER INDIA PVT LTD", "maker_model": "ACTIVA 5G", "body_type": "SCOOTER", "fuel_type": "PETROL", "color": "BLACK", "norms_type": "BS4", "financer": "", "financed": false, "insurance_company": "ICICI Lombard General Insurance Co. Ltd.", "insurance_policy_number": "IC1234567890", "insurance_upto": "2025-12-20", "manufacturing_date": "12/2017", "manufacturing_date_formatted": "2017-12", "registered_at": "DELHI, Delhi", "latest_by": "2025-08-29", "less_info": true, "tax_upto": "2032-12-15", "tax_paid_upto": "2032-12-15", "cubic_capacity": "109.19", "vehicle_gross_weight": "0", "no_cylinders": "1", "seat_capacity": "2", "sleeper_capacity": null, "standing_capacity": null, "wheelbase": null, "unladen_weight": "109", "vehicle_category_description": "Scooter(2WN)", "pucc_number": "DL009876543210", "pucc_upto": "2025-11-25", "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": null, "non_use_status": null, "non_use_from": null, "non_use_to": null, "blacklist_status": "", "noc_details": "", "owner_number": "1", "rc_status": null, "rto_code": null, "response_metadata": { "masked_chassis": true, "masked_engine": true, "masked_owner_name": true } }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

RC V2

RC V2 API#

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