Mobile To RC

Endpoint Overview

POST /api/v1/rc/mobile-number-to-rc

Description

This API endpoint allows you to retrieve the Registration Certificate (RC) numbers associated with a specific mobile number. It provides a convenient way to look up vehicle registration details when only the mobile number of the vehicle owner is available. The service performs a search across the vehicle registration database and returns all RC numbers linked to the provided mobile number.

Key Benefits

Quickly verify vehicle ownership using just a mobile number

Retrieve multiple RC numbers associated with a single mobile number

Simplify vehicle verification processes for financial and insurance services

Reduce manual data entry and potential errors in vehicle identification

Use Cases

Financial Services

Transportation

Government & Law Enforcement

Verify vehicle ownership during loan application processing

Validate collateral information for vehicle-backed loans

Streamline vehicle insurance policy issuance by confirming ownership details

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

Request Body

Parameter	Type	Required	Description
mobile_number	String	Yes	The mobile number to search for associated RC numbers. Must be a valid 10-digit Indian mobile number.

Example Request

{
    "mobile_number": "8908885858"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the response data
data.client_id	String	Unique identifier for the API request
data.rc_number	Array of Strings	List of RC numbers associated with the provided mobile number
data.mobile_number	String	The mobile number that was provided in the request
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates whether the API call was successful
message	String	Human-readable message describing the result
message_code	String	Machine-readable code indicating the result type

Example Successful Response

{
    "data": {
        "client_id": "mobile_number_to_rc_ubFojfkItBiHxioFbzJz",
        "rc_number": [
            "RJ14XJ1234"
        ],
        "mobile_number": "8908885858"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Mobile Number

No RC Found

Authentication Error

{
    "errors": {
        "mobile": "Mobile Number Value does not match pattern: \"^[0][1-9]\\d{9}$|^[1-9]\\d{9}$\""
    },
    "message": "Input payload validation failed"
}

The mobile number provided is not in a valid format. Ensure it is a 10-digit number.

Integration Best Practices

Security Recommendations

Store API credentials 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 in transit

Implement rate limiting on your end to prevent abuse of the API

User Experience Guidelines

Validate mobile number format before making the API call to reduce errors

Implement proper loading states while waiting for the API response

Display clear error messages to users when RC numbers cannot be found

Consider caching results temporarily for frequently accessed mobile numbers

Code Samples

cURL

Python

Node.js

Related APIs

RC Details by RC Number: Retrieve detailed vehicle information using an RC number

RC Verification: Verify the authenticity of an RC number against official records

Vehicle History: Get comprehensive history of a vehicle using its RC number

Compliance and Legal Considerations

This API accesses vehicle registration information that may be subject to privacy regulations. Ensure you have proper consent from users before querying their mobile numbers, and handle the returned data in accordance with applicable data protection laws. The use of this API should comply with the Motor Vehicles Act and related regulations governing vehicle registration information in India.

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/mobile-number-to-rc' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "mobile_number": "8908885858" }'

{ "data": { "client_id": "mobile_number_to_rc_ubFojfkItBiHxioFbzJz", "rc_number": [ "RJ14XJ1234" ], "mobile_number": "8908885858" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Mobile To RC

Mobile 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

Mobile 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