FASTag Verification V2

Endpoint Overview

POST /api/v1/fastag/fastag-verification-v2

Description

The FASTag Verification V2 API allows you to verify and retrieve comprehensive details about a FASTag associated with a vehicle registration number. This API provides information about the FASTag's status, issuing bank, tag ID, and a chronological list of toll transactions made using the FASTag. This enables businesses to validate FASTag authenticity, track vehicle movement patterns, and analyze toll usage history.

Key Benefits

Instant verification of FASTag status and authenticity

Access to detailed transaction history with geographical data

Verification of vehicle type consistency across toll plazas

Real-time insights into vehicle movement patterns and toll usage

Use Cases

Logistics & Fleet Management

Financial Services

Highway Management

Track and verify toll expenses for fleet vehicles

Reconcile toll charges with driver route reports

Monitor vehicle movement patterns across highways

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

Example Request

{
    "rc_number": "CG07BC1234"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the FASTag verification details
data.client_id	String	Unique identifier for the client
data.rc_number	String	Vehicle registration number provided in the request
data.bank_name	String	Name of the bank that issued the FASTag
data.tag_id	String	Unique identifier for the FASTag
data.transactions	Array	List of toll transactions made using the FASTag
data.status	String	Current status of the FASTag (e.g., "Active")
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Response message
message_code	String	Code representing the response message

Transaction Object Structure

Parameter	Type	Description
lane_direction	String	Direction of the toll lane (e.g., "S" for South)
transaction_date_time	String	Date and time of the transaction in ISO 8601 format
seq_no	String	Unique sequence number for the transaction
toll_plaza_geocode	String	Geographic coordinates of the toll plaza
toll_plaza_name	String	Name of the toll plaza where transaction occurred
vehicle_type	String	Vehicle classification code (e.g., "VC13")

Example Successful Response

{
    "data": {
        "client_id": "fastag_verification_v2_rztQxpTMfyoaKoybGskj",
        "rc_number": "CG07BC1234",
        "bank_name": "IDFC First Bank",
        "tag_id": "34161FA812348EE1234BCFE0",
        "transactions": [
            {
                "lane_direction": "S",
                "transaction_date_time": "2024-07-16T19:00:16",
                "seq_no": "0010012407161901268650",
                "toll_plaza_geocode": "22.34462627,87.12665241",
                "toll_plaza_name": "Balibhasa Toll Plaza",
                "vehicle_type": "VC13"
            },
            {
                "lane_direction": "S",
                "transaction_date_time": "2024-07-16T21:07:11",
                "seq_no": "0010032407162107431473",
                "toll_plaza_geocode": "22.180518, 86.636253",
                "toll_plaza_name": "Jharpokharia Toll Plaza",
                "vehicle_type": "VC13"
            },
            {
                "lane_direction": "S",
                "transaction_date_time": "2024-07-17T06:46:41",
                "seq_no": "172117923267624502481",
                "toll_plaza_geocode": "21.705647,85.697266",
                "toll_plaza_name": "Khireitangiri Toll Plaza",
                "vehicle_type": "VC13"
            },
            {
                "lane_direction": "S",
                "transaction_date_time": "2024-07-17T23:21:31",
                "seq_no": "172123887618924709963",
                "toll_plaza_geocode": "21.705647,85.697266",
                "toll_plaza_name": "Khireitangiri Toll Plaza",
                "vehicle_type": "VC13"
            }
        ],
        "status": "Active"
    },
    "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 PAN number does not match the required format or contains invalid characters.

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement proper error handling to prevent leaking sensitive information

Use HTTPS for all API communications to ensure data encryption

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

User Experience Guidelines

Cache FASTag verification results for frequently checked vehicles to improve response times

Implement progressive loading for transaction history if displaying in a UI

Format transaction dates in a user-friendly way when displaying to end-users

Provide clear error messages to users when verification fails

Code Samples

cURL

Python

Node.js

Related APIs

Vehicle Registration Verification API: Verify vehicle registration details

Vehicle Ownership Transfer API: Check and process ownership transfers

Vehicle Insurance Verification API: Verify insurance status of vehicles

Compliance and Legal Considerations

The FASTag data is subject to privacy regulations. Ensure you have proper consent before accessing and storing this information. The transaction data may contain location information that is considered sensitive personal data under various privacy laws. Implement appropriate data protection measures and retention policies.

{ "data": { "client_id": "fastag_verification_v2_rztQxpTMfyoaKoybGskj", "rc_number": "CG07BC1234", "bank_name": "IDFC First Bank", "tag_id": "34161FA812348EE1234BCFE0", "transactions": [ { "lane_direction": "S", "transaction_date_time": "2024-07-16T19:00:16", "seq_no": "0010012407161901268650", "toll_plaza_geocode": "22.34462627,87.12665241", "toll_plaza_name": "Balibhasa Toll Plaza", "vehicle_type": "VC13" }, { "lane_direction": "S", "transaction_date_time": "2024-07-16T21:07:11", "seq_no": "0010032407162107431473", "toll_plaza_geocode": "22.180518, 86.636253", "toll_plaza_name": "Jharpokharia Toll Plaza", "vehicle_type": "VC13" }, { "lane_direction": "S", "transaction_date_time": "2024-07-17T06:46:41", "seq_no": "172117923267624502481", "toll_plaza_geocode": "21.705647,85.697266", "toll_plaza_name": "Khireitangiri Toll Plaza", "vehicle_type": "VC13" }, { "lane_direction": "S", "transaction_date_time": "2024-07-17T23:21:31", "seq_no": "172123887618924709963", "toll_plaza_geocode": "21.705647,85.697266", "toll_plaza_name": "Khireitangiri Toll Plaza", "vehicle_type": "VC13" } ], "status": "Active" }, "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 V2

FASTag Verification V2#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Transaction Object Structure#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses