Vehicle Application Status

Endpoint Overview

POST /api/v1/rc/vehicle-application-status

Description

This API retrieves detailed information about a vehicle's registration application status. It provides comprehensive details about all transactions related to a specific vehicle, including application numbers, transaction purposes, dates, and current status. This endpoint is particularly useful for tracking the progress of vehicle registration applications and related transactions in the RTO (Regional Transport Office) system.

Key Benefits

Track multiple transactions related to a single vehicle registration

Verify the status of vehicle registration applications in real-time

Access historical transaction data for compliance and record-keeping

Simplify user verification processes for vehicle-related services

Use Cases

Automotive

Financial Services

Government & Compliance

Vehicle dealers tracking registration status of newly sold vehicles

Insurance companies verifying registration status before policy issuance

Fleet management companies monitoring registration renewals

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., "GJ01XX0001")

Example Request

{
    "rc_number": "GJ01XX0001"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.client_id	String	Unique identifier for the client making the request
data.rc_number	String	Vehicle registration number that was queried
data.details	Array	List of application transactions related to the vehicle
data.details[].application_number	String	Unique application number for the transaction
data.details[].transaction_purpose	String	Purpose of the transaction (e.g., "New Registration", "MV Tax")
data.details[].transaction_date	String	Date of the transaction in YYYY-MM-DD format
data.details[].transaction_status	String	Current status of the transaction (e.g., "Successful", "Failed", "Pending")
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the request was successful
message	String	Human-readable message describing the result
message_code	String	Machine-readable code for the message

Example Successful Response

{
    "data": {
        "client_id": "vehicle_application_status_ZqsFexcXlrBQIPwmZgbw",
        "rc_number": "UP61AX1234",
        "details": [
            {
                "application_number": "UP210629123456",
                "transaction_purpose": "New Registration",
                "transaction_date": "2021-06-29",
                "transaction_status": "Successful"
            },
            {
                "application_number": "UP210629123456",
                "transaction_purpose": "MV Tax",
                "transaction_date": "2021-06-29",
                "transaction_status": "Successful"
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Vehicle Number

Authentication Error

{
    "status_code": 422,
    "success": false,
    "message": "Verification Failed.",
    "message_code": "verification_failed"
}

This error occurs when the provided vehicle registration number does not match the expected format.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement token refresh mechanisms to handle token expiration

Validate and sanitize the vehicle registration number before sending the request

Use HTTPS for all API communications to ensure data encryption in transit

User Experience Guidelines

Implement proper error handling to provide meaningful feedback to users

Display transaction history in chronological order for better readability

Use color coding to highlight transaction status (successful, pending, failed)

Implement pagination if displaying multiple transaction records

Code Samples

cURL

Python

Node.js

Related APIs

Vehicle Registration Certificate Details API - Retrieves comprehensive details of a vehicle's registration certificate

Vehicle Ownership Transfer Status API - Tracks the status of ownership transfer applications

Vehicle Fitness Certificate API - Provides information about a vehicle's fitness certificate status

Vehicle Tax Payment Status API - Checks the status of vehicle tax payments

Compliance and Legal Considerations

This API provides access to vehicle registration data that may be subject to privacy regulations. Ensure you have proper consent from vehicle owners before accessing their data. Usage of this API must comply with local transport authority regulations and data protection laws. The data should only be used for legitimate business purposes as authorized by the relevant transport authorities.

{ "data": { "client_id": "vehicle_application_status_ZqsFexcXlrBQIPwmZgbw", "rc_number": "UP61AX1234", "details": [ { "application_number": "UP210629123456", "transaction_purpose": "New Registration", "transaction_date": "2021-06-29", "transaction_status": "Successful" }, { "application_number": "UP210629123456", "transaction_purpose": "MV Tax", "transaction_date": "2021-06-29", "transaction_status": "Successful" } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Vehicle Application Status

Vehicle Application Status#

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

Vehicle Application Status

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples