RC To IDV Details

Endpoint Overview

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

Description

This API takes a vehicle’s Registration Certificate (RC) number as input and returns its Insured Declared Value (IDV). It enables insurance providers, brokers, and financial institutions to quickly estimate a vehicle's insurable value based on its RC number.

Key Benefits

Automates IDV estimation for vehicle insurance workflows.

Reduces manual errors and increases operational efficiency.

Enables real-time integration into underwriting systems.

Quick turnaround with minimal input data.

Use Cases

Insurance

Vehicle Resale

Finance & Loans

Instant IDV value generation for vehicle insurance quotes.

Integration into underwriting systems for automated policy issuance.

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 API access
Content-Type	Yes	Must be `application/json`

Request Body

Parameter	Type	Required	Description
id_number	string	Yes	Vehicle RC number (e.g., UP61AX8729)

Example Request

{
    "id_number": "UP61AX8729"
}

Process Response

Response Parameters

Parameter	Type	Description
client_id	string	Unique client request ID
rc_number	string	Submitted vehicle RC number
idv_value	float	Calculated IDV value of the vehicle
status_code	integer	HTTP status code
success	boolean	API success status
message	string	Error or success message (nullable)
message_code	string	Status code string (e.g., "success")

Example Successful Response

{
    "data": {
        "client_id": "rc_to_idv_details_lVTesQhudwjirZcuAmoG",
        "rc_number": "UP61AX8729",
        "idv_value": 42225.0
    },
    "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

Always use HTTPS to protect sensitive information.

Keep your API tokens secure and rotate them periodically.

User Experience Guidelines

Validate RC number format before sending the request.

Handle and display IDV values clearly for end-user understanding.

Code Samples

cURL

Python

Node.js

Related APIs

RC to Owner Details: Fetches owner details using vehicle RC number.

RC to Hypothecation Details: Retrieves hypothecation status and loan info from RC.

RC to Vehicle Details: Provides comprehensive vehicle details from RC.

Compliance and Legal Considerations

Ensure usage complies with regional data protection regulations. Do not store or misuse personal vehicle data obtained through this API.

{ "data": { "client_id": "rc_to_idv_details_lVTesQhudwjirZcuAmoG", "rc_number": "UP61AX8729", "idv_value": 42225 }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

RC To IDV Details

RC To IDV Details#

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 To IDV Details

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples