FASTag Balance Premium API

Introduction

The FASTag Balance Premium API returns the live FASTag wallet balance of an Indian vehicle, along with how much more can be recharged and the status of the tag. You send the vehicle's registration number. In return you get the available balance, the available recharge limit, the tag status and the account holder's name as held by the issuer.

Sample Curl

curl --location 'https://api-preproduction.signzy.app/api/v3/vehicle/fastag-balance/premium' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Auth Token>' \
--data '{
    "vehicleNumber": "MH03CM4824"
}'

Input Parameters

Parameter	Description	Required
vehicleNumber	Vehicle registration number Example: MH03CM4824.	Yes

Sample Response

{
  "result": {
    "vehicleNumber": "MH03CM4824",
    "providerName": "axis_bank",
    "providerCode": "<NETC issuer code>",
    "customerName": "Ravi Kumar",
    "availableRechargeLimit": "2500.00",
    "availableBalance": "1240.00",
    "tagStatus": "Active",
    "vehicleClass": "VC4",
    "vehicleClassDesc": "CAR/JEEP/VAN",
    "modelName": "<Model name>"
  }
}

Response Parameters

PARAMETER NAME	DATA TYPE	DESCRIPTION
result	Object	Wrapper for the successful response.
result.vehicleNumber	String	Registration number as resolved by the issuer, in upper case.
result.providerName	String	The providerName from the request, returned unchanged.
result.providerCode	String	NETC issuer code of the provider, for example AIRT00000NATVI.
result.customerName	String	Name of the FASTag account holder as registered with the issuer. This may differ from the registered owner on the RC.
result.availableBalance	String	Current usable wallet balance in INR, as a decimal string, for example 862.45.
result.availableRechargeLimit	String	Maximum amount in INR that can still be recharged into the wallet, as a decimal string, for example 25000.0. Depends on the account's KYC tier.
result.tagStatus	String	Status of the tag as reported by the issuer, for example Active, Low Balance or Blacklist. Values come directly from the issuer and are not normalised. Treat any value other than Active as needing attention.
result.vehicleClass	String	NETC vehicle class code, for example VC4. Empty string if the issuer does not supply it.
result.vehicleClassDesc	String	Readable vehicle class, for example CAR/JEEP/VAN. Empty string if the issuer does not supply it.
result.modelName	String	Vehicle model as recorded by the issuer. Empty string if the issuer does not supply it.

Error Code Response & Mapping

{
    "error": {
        "name": "error",
        "message": "No FASTag found for the given vehicle number.",
        "status": 404,
        "reason": "No record found",
        "type": "Not Found",
        "statusCode": 404
    }
}

Field	Type	Description
name	string	Text displayed on the screen explaining error type.
reason	string	Reason for the error.
status	number	HTTP status code.
message	string	Error message indicating an upstream error.
type	string	Error type.
statusCode	number	Status code representing the error scenario.

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!