RC Full API

Endpoint Overview

POST /api/v1/rc/rc-full

Description

The RC Full API provides comprehensive and authoritative data on registered vehicles in India. By integrating with official vehicle registration databases, it delivers detailed information such as vehicle specifications, registration details, ownership data, insurance coverage, and permit status. This API is ideal for businesses that need to validate vehicle authenticity, perform compliance checks, or access critical registration data.

Key Benefits

Retrieve real-time and verified vehicle registration data.

Enables automated vehicle verification for onboarding and underwriting.

Facilitates fraud detection through ownership validation.

Offers a single source for all key vehicle-related metadata.

Use Cases

Insurance

Banking & NBFC

Automobile Portals

Pre-insurance verification and validation of vehicle details.

Claims processing with accurate 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.io

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

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token obtained from Surepass

Request Body

Parameter	Type	Required	Description
id_number	string	Yes	Vehicle registration number (e.g., RJ12XJ1234)

Example Request

{
  "id_number": "RJ12XJ1234"
}

Process Response

Response Parameters

Parameter	Type	Description
client_id	string	Unique client ID associated with the request
rc_number	string	Registered vehicle number
registration_date	string	Vehicle registration date
owner_name	string	Name of the vehicle owner
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	Category of the vehicle
vehicle_chasi_number	string	Chassis number of the vehicle
vehicle_engine_number	string	Engine number of the vehicle
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
fit_up_to	string	Validity of fitness certificate
financer	string	Name of the financer
financed	boolean	Indicates whether vehicle is financed
insurance_company	string	Insurance provider name
insurance_policy_number	string	Policy number of the vehicle 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/null	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	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 PUCC
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	Permit expiry date
permit_type	string	Type of permit
national_permit_number	string/null	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 of non-use
non_use_to	string/null	End of non-use
blacklist_status	string/null	Vehicle blacklist status
noc_details	string/null	NOC (No Objection Certificate) details
owner_number	string	Number of owners so far
rc_status	string/null	Status of RC
masked_name	boolean	Whether name is masked
challan_details	string/null	Challan details if any
variant	string/null	Vehicle variant

Example Successful Response

{
  "data": {
    "client_id": "rc_dSpdBzqCodglkkoQkmeu",
    "rc_number": "AB12CD3456",
    "registration_date": "2017-09-05",
    "owner_name": "Munna Bhaiya",
    "father_name": "Kaleen Bhaiya",
    "present_address": "HNO 1-10/2 Mirzapur",
    "permanent_address": "HNO 1-10/2 Mirzapur",
    "mobile_number": "",
    "vehicle_category": "HPV",
    "vehicle_chasi_number": "ABCD12LRT0HH123456",
    "vehicle_engine_number": "ABCD12H123456",
    "maker_description": "VEHICLES LTD",
    "maker_model": "EICHER PRO BSIV",
    "body_type": "SALOON",
    "fuel_type": "DIESEL",
    "color": "WHITE",
    "norms_type": "BHARAT STAGE IV",
    "fit_up_to": "2099-09-00",
    "financer": "FINANCE LTD",
    "financed": true,
    "insurance_company": "Assurance Company Limited",
    "insurance_policy_number": "0000023123456789",
    "insurance_upto": "2099-00-04",
    "manufacturing_date": "8/1947",
    "manufacturing_date_formatted": "1947-08",
    "registered_at": "RTO",
    "latest_by": "1497-00-27",
    "less_info": true,
    "tax_upto": null,
    "tax_paid_upto": "1857-11-30",
    "cubic_capacity": "3298",
    "vehicle_gross_weight": "9850",
    "no_cylinders": "4",
    "seat_capacity": "50",
    "sleeper_capacity": null,
    "standing_capacity": null,
    "wheelbase": "5260",
    "unladen_weight": "6110",
    "vehicle_category_description": "Bus",
    "pucc_number": "",
    "pucc_upto": null,
    "permit_number": "123/AB/45/64",
    "permit_issue_date": null,
    "permit_valid_from": null,
    "permit_valid_upto": "2080-11-06",
    "permit_type": "TEMPORARY PERMIT",
    "national_permit_number": null,
    "national_permit_upto": null,
    "national_permit_issued_by": null,
    "non_use_status": null,
    "non_use_from": null,
    "non_use_to": null,
    "blacklist_status": null,
    "noc_details": null,
    "owner_number": "1",
    "rc_status": null,
    "masked_name": false,
    "challan_details": null,
    "variant": 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

Keep your JWT token secure and rotate it regularly.

Use HTTPS for all API communications to avoid MITM attacks.

Validate all incoming and outgoing data in your system.

User Experience Guidelines

Provide clear error messages to users when data is incomplete.

Display loading indicators while data is being fetched.

Code Samples

cURL

Python

Node.js

Related APIs

RC Basic API: Basic vehicle registration information for quick lookups.

DL Verification API: Retrieve and validate Indian driving license details.

Challan API: Get e-challan history of vehicles by registration number.

Compliance and Legal Considerations

Ensure you comply with data privacy laws such as the IT Act and DPDP. Use the API strictly for authorized and legal business purposes such as underwriting, verification, or regulatory compliance.

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

{ "data": { "client_id": "rc_dSpdBzqCodglkkoQkmeu", "rc_number": "AB12CD3456", "registration_date": "2017-09-05", "owner_name": "Munna Bhaiya", "father_name": "Kaleen Bhaiya", "present_address": "HNO 1-10/2 Mirzapur", "permanent_address": "HNO 1-10/2 Mirzapur", "mobile_number": "", "vehicle_category": "HPV", "vehicle_chasi_number": "ABCD12LRT0HH123456", "vehicle_engine_number": "ABCD12H123456", "maker_description": "VEHICLES LTD", "maker_model": "EICHER PRO BSIV", "body_type": "SALOON", "fuel_type": "DIESEL", "color": "WHITE", "norms_type": "BHARAT STAGE IV", "fit_up_to": "2099-09-00", "financer": "FINANCE LTD", "financed": true, "insurance_company": "Assurance Company Limited", "insurance_policy_number": "0000023123456789", "insurance_upto": "2099-00-04", "manufacturing_date": "8/1947", "manufacturing_date_formatted": "1947-08", "registered_at": "RTO", "latest_by": "1497-00-27", "less_info": true, "tax_upto": null, "tax_paid_upto": "1857-11-30", "cubic_capacity": "3298", "vehicle_gross_weight": "9850", "no_cylinders": "4", "seat_capacity": "50", "sleeper_capacity": null, "standing_capacity": null, "wheelbase": "5260", "unladen_weight": "6110", "vehicle_category_description": "Bus", "pucc_number": "", "pucc_upto": null, "permit_number": "123/AB/45/64", "permit_issue_date": null, "permit_valid_from": null, "permit_valid_upto": "2080-11-06", "permit_type": "TEMPORARY PERMIT", "national_permit_number": null, "national_permit_upto": null, "national_permit_issued_by": null, "non_use_status": null, "non_use_from": null, "non_use_to": null, "blacklist_status": null, "noc_details": null, "owner_number": "1", "rc_status": null, "masked_name": false, "challan_details": null, "variant": null }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

RC Full

RC Full 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