Fastag Verification API

Endpoint Overview

POST /api/v1/fastag/verification

Description

The Fastag Verification API allows you to validate and retrieve details of a vehicle's Fastag by providing the vehicle's registration (RC) number. This API returns comprehensive information about the Fastag including the associated bank, tag ID, and current status, enabling seamless verification of Fastag credentials for toll collection systems, parking management, and vehicle fleet management applications.

Key Benefits

Instant verification of Fastag validity and status

Retrieval of complete Fastag details including bank and tag ID

Simplified integration with toll collection and parking management systems

Reduced manual verification processes and associated errors

Use Cases

Toll Management

Parking Solutions

Fleet Management

Verify Fastag validity before allowing vehicles through toll plazas

Automate toll collection by confirming active Fastag status

Reduce congestion by pre-validating Fastag details

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
rc_number	string	Yes	The vehicle registration number for which Fastag details are to be verified

Example Request

{
    "rc_number": "GJ05CN4635"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Container for the Fastag verification result
data.client_id	string	Unique identifier for the verification request
data.rc_number	string	Vehicle registration number that was verified
data.bank_name	string	Name of the bank that issued the Fastag
data.tag_id	string	Unique identifier of 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 verification was successful
message	string	Human-readable description of the response
message_code	string	Machine-readable code for the response

Example Successful Response

{
    "data": {
        "client_id": "fastag_verification_dRKBysWbCksWhLlUpdrx",
        "rc_number": "GJ05CN0000",
        "bank_name": "",
        "tag_id": "0000FA00008EE81FCA123",
        "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 JWT tokens securely and never expose them in client-side code

Implement token refresh mechanisms to handle token expiration

Use HTTPS for all API communications to ensure data encryption

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Implement client-side validation of RC number format before making API calls

Display clear error messages to users when verification fails

Implement caching strategies to reduce redundant API calls for the same RC number

Show loading indicators during API calls to improve perceived performance

Code Samples

cURL

Python

Node.js

Related APIs

Vehicle Registration Verification API: Verify vehicle registration details

Driving License Verification API: Verify driving license information

Vehicle Insurance Verification API: Check insurance status of vehicles

Compliance and Legal Considerations

This API accesses Fastag information which may be subject to regulations by the National Highways Authority of India (NHAI) and the Indian Toll Collection System. Ensure you have proper authorization to access this data and comply with all relevant data protection regulations. The data should only be used for legitimate business purposes with appropriate user consent.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/fastag/verification' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "rc_number": "GJ05CN4635" }'

{ "data": { "client_id": "fastag_verification_dRKBysWbCksWhLlUpdrx", "rc_number": "GJ05CN0000", "bank_name": "", "tag_id": "0000FA00008EE81FCA123", "status": "Active" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Fastag

Fastag Verification API#

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