Fastag To RC

Endpoint Overview

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

Description

This API allows you to retrieve vehicle registration details by providing a FASTag ID. It returns comprehensive information including the vehicle's registration number, tag status, vehicle class, issue date, and the bank that issued the FASTag. This service enables seamless verification of vehicle information using FASTag identifiers, eliminating the need for manual document checks.

Key Benefits

Instant verification of vehicle registration details using FASTag ID

Reduces manual verification efforts and paperwork

Helps prevent fraud by confirming legitimate vehicle-FASTag associations

Enables automated vehicle identification for toll systems and parking solutions

Use Cases

Toll Management

Parking Solutions

Fleet Management

Verify vehicle details at toll plazas to ensure FASTag is associated with the correct vehicle

Automate vehicle classification for appropriate toll charging

Detect potential FASTag misuse by comparing vehicle class with physical vehicle

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. Format: `Bearer <your_jwt_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 needs to be verified

Example Request

{
    "fastag_id": "34161FA123456EE81E41EAE0"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the retrieved vehicle and FASTag information
data.client_id	String	Unique identifier for the client making the request
data.fastag_id	String	The unique identifier for the FASTag that was queried
data.rc_number	String	The registration number of the vehicle associated with the FASTag
data.tag_status	String	Current status of the FASTag (e.g., ACTIVE, INACTIVE)
data.vehicle_class	String	The class of the vehicle as registered with the FASTag
data.issue_date	String	The date when the FASTag was issued (YYYY-MM-DD format)
data.issuer_bank	String	The financial institution that issued the FASTag
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the API call was successful
message	String	Human-readable description of the API call result
message_code	String	Machine-readable code representing the API call result

Example Successful Response

{
    "data": {
        "client_id": "fastag_to_rc_OPartnFuEJMAwiUTWbsA",
        "fastag_id": "34161FA123456EE81E41EAE0",
        "rc_number": "GJ05XX1234",
        "tag_status": "ACTIVE",
        "vehicle_class": "VC4",
        "issue_date": "2022-10-20",
        "issuer_bank": "IDFC Bank"
    },
    "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 token rotation and expiration policies to minimize security risks

Use HTTPS for all API communications to ensure data is encrypted in transit

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Implement caching strategies to improve response times for frequently queried FASTag IDs

Display clear error messages to end-users when FASTag verification fails

Provide visual indicators during the verification process to show system status

Include fallback mechanisms for manual verification when automated checks fail

Code Samples

cURL

Python

Node.js

Related APIs

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

FASTag Balance Check API: Check the available balance on a FASTag

Vehicle Ownership Transfer API: Verify and process vehicle ownership transfers

Compliance and Legal Considerations

This API accesses vehicle registration information which may be subject to data protection regulations. Ensure you have proper consent from users before accessing their vehicle information. Usage of this API should comply with the National Electronic Toll Collection (NETC) program guidelines and relevant transportation authority regulations. Data retrieved should be stored securely and used only for the intended verification purposes.

{ "data": { "client_id": "fastag_to_rc_OPartnFuEJMAwiUTWbsA", "fastag_id": "34161FA123456EE81E41EAE0", "rc_number": "GJ05XX1234", "tag_status": "ACTIVE", "vehicle_class": "VC4", "issue_date": "2022-10-20", "issuer_bank": "IDFC Bank" }, "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

Fastag 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

Fastag 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