RC To Mobile

Endpoint Overview

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

Description

This API endpoint allows you to retrieve the mobile number associated with a specific vehicle registration (RC) number. It provides a secure and efficient way to verify the connection between a vehicle and its registered owner's contact information, which is essential for various verification and authentication processes.

Key Benefits

Instant verification of mobile numbers linked to vehicle registration

Reduces manual verification efforts and associated costs

Helps prevent fraud by confirming authentic vehicle-owner relationships

Streamlines customer onboarding for automotive and insurance services

Use Cases

Automotive

Insurance

Financial Services

Vehicle ownership verification during used car transactions

Service center appointment scheduling and customer verification

Automated customer communication for vehicle maintenance alerts

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	Application/json

Request Body

Parameter	Type	Required	Description
rc_number	String	Yes	Vehicle Registration Number (e.g., "RJ14XJ1234")

Example Request

{
    "rc_number": "RJ14XJ1234"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the retrieved information
data.client_id	String	Unique identifier for the API request
data.rc_number	String	The vehicle registration number provided in the request
data.mobile_number	String	Mobile number associated with the RC number
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

Example Successful Response

{
    "data": {
        "client_id": "rc_to_mobile_number_WmrcRThlcmadfhblXtvQ",
        "rc_number": "RJ14XJ1234",
        "mobile_number": "8890856565"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "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 in transit

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

User Experience Guidelines

Implement proper validation for RC number format before making API calls

Display clear error messages to users when verification fails

Include loading indicators during API calls to improve perceived performance

Cache results when appropriate to reduce redundant API calls

Code Samples

cURL

Python

Node.js

Related APIs

RC Verification API: Validates and retrieves comprehensive details about a vehicle registration

Vehicle History API: Provides historical information about a vehicle including ownership changes

Owner Verification API: Verifies the identity of a vehicle owner against provided information

Compliance and Legal Considerations

This API provides access to personal information (mobile numbers) and must be used in compliance with data protection regulations. Ensure you have proper consent from users before accessing their information and that you handle the retrieved data according to applicable privacy laws such as GDPR or local data protection regulations.

{ "data": { "client_id": "rc_to_mobile_number_WmrcRThlcmadfhblXtvQ", "rc_number": "RJ14XJ1234", "mobile_number": "8890856565" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

RC To Mobile

RC To Mobile#

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 Mobile

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples