Fastag To RC Advanced

Endpoint Overview

POST /api/v1/fastag/fastag-to-rc-advanced

Description

This API enables you to retrieve the Vehicle Registration Number (RC Number) associated with a specific Fastag ID. It provides a reliable method to link electronic toll collection tags to vehicle registration details, helping verify vehicle ownership and identity through Fastag credentials.

Key Benefits

Instant verification of vehicle registration details using only Fastag ID

Reduces manual verification processes and paperwork

Helps prevent fraud by confirming legitimate vehicle-Fastag associations

Enables automated vehicle identification for toll systems, parking, and fleet management

Use Cases

Toll Management

Fleet Management

Financial Services

Verify vehicle registration details at toll plazas for dispute resolution

Link toll payment history with specific vehicles for audit purposes

Validate vehicle class against registered details to prevent toll evasion

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	JWT Bearer token for authentication. Format: `Bearer <your_token>`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
fastag_id	String	Yes	The unique identifier for the FasTag that is linked to a vehicle

Example Request

{
    "fastag_id": "34161FA820328EE829DC9307"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the result data
data.client_id	String	Unique identifier for the client making the request
data.fastag_id	String	The FasTag ID that was provided in the request
data.rc_number	String	The vehicle registration number associated with the FasTag
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates whether the request was successful
message	String	Human-readable description of the response status
message_code	String	Machine-readable code representing the response status

Example Successful Response

{
    "data": {
        "client_id": "fastag_to_rc_advanced_zhuMDqKjAifTsNuvgjQa",
        "fastag_id": "76341FA820328EE829DC9200",
        "rc_number": "MH12VL1234"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Fastag ID

Authentication Error

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

The provided PAN number does not match the required format or contains invalid characters.

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

Rotate JWT tokens periodically and implement token expiration policies

User Experience Guidelines

Implement caching for frequently accessed Fastag-to-RC mappings to improve response times

Display clear error messages to end-users when Fastag validation fails

Provide a fallback verification method when Fastag details cannot be retrieved

Include loading indicators during API calls to improve perceived performance

Code Samples

cURL

Python

Node.js

Related APIs

Fastag Balance Check API: Retrieve the current balance of a Fastag account

Vehicle RC Verification API: Verify vehicle registration details using RC number

Fastag Transaction History API: Get transaction history for a specific Fastag ID

Compliance and Legal Considerations

This API involves accessing vehicle registration information, which may be subject to data privacy regulations. Ensure you have proper consent from users before accessing their vehicle information. Usage of this API must comply with the Motor Vehicles Act and relevant data protection laws in your jurisdiction. The data should only be used for legitimate business purposes as outlined in your service agreement with Surepass.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/fastag/fastag-to-rc-advanced' \ --header 'Content-Type: application/json' \ --data-raw '{ "fastag_id": "34161FA820328EE829DC9307" }'

{ "data": { "client_id": "fastag_to_rc_advanced_zhuMDqKjAifTsNuvgjQa", "fastag_id": "76341FA820328EE829DC9200", "rc_number": "MH12VL1234" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Fastag To RC Advanced

Fastag To RC Advanced#

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

Fastag To RC Advanced

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples