Get Provider List

Endpoint Overview

GET /api/v1/fastag/get-provider-list

Description

This API endpoint retrieves a comprehensive list of all available FASTag service providers supported by the platform. It allows developers to access the complete catalog of banks and financial institutions that offer FASTag services, enabling applications to present users with all available options for FASTag-related transactions.

Key Benefits

Access the complete list of supported FASTag service providers in a single API call

Stay updated with the latest available providers without hardcoding values

Implement dynamic provider selection in your applications

Ensure your application always displays current and valid provider options

Use Cases

Financial Services

Transportation

Digital Wallets

Build FASTag recharge platforms with complete provider coverage

Develop multi-bank FASTag management dashboards

Create comparison tools for FASTag services across providers

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

This endpoint does not require a request body.

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.provider_name	Array	List of available FASTag service provider names
status_code	Integer	HTTP status code of the response
message_code	String	Short code indicating the status of the request
message	String	Human-readable message describing the result
success	Boolean	Indicates whether the request was successful

Example Successful Response

{
    "data": {
        "provider_name": [
            "au_bank",
            "axis_bank",
            "canara_bank",
            "union_bank_of_india",
            "uco_bank",
            "federal_bank_-",
            "airtel_payments_bank_netc",
            "indian_bank_recharge",
            "idfc_first_bank",
            "equitas_recharge",
            "iob",
            "karnataka_bank",
            "hdfc_bank",
            "yes_bank",
            "bajaj_pay",
            "bank_of_baroda",
            "jammu_and_kashmir_bank",
            "indusind_bank",
            "idbi_bank",
            "indian_highways_management_company_ltd",
            "livquik_technology_india_private_limited",
            "state_bank_of_india_netc",
            "icici_bank",
            "south_indian_bank",
            "bandhan_bank",
            "bank_of_maharashtra",
            "kotak_mahindra_bank"
        ]
    },
    "status_code": 200,
    "message_code": "success",
    "message": "Success",
    "success": true
}

Possible Error Responses

Authentication Error

Server Error

{
    "status_code": 401,
    "message_code": "unauthorized",
    "message": "Invalid or expired token",
    "success": false
}

This error occurs when the JWT token is missing, invalid, or expired.

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 security

Implement proper error handling for authentication failures

User Experience Guidelines

Cache provider list to reduce API calls and improve application performance

Implement a fallback UI in case the API is temporarily unavailable

Display provider names in a user-friendly format (convert underscores to spaces, capitalize properly)

Consider grouping providers by type (banks, payment services, etc.) for better organization

Code Samples

cURL

Python

Node.js

Related APIs

FASTag Balance Check API: Retrieve the current balance for a FASTag

FASTag Recharge API: Add funds to a FASTag account

FASTag Transaction History API: Get a list of past transactions for a FASTag

FASTag Registration API: Register a new FASTag with a service provider

Compliance and Legal Considerations

When displaying FASTag provider information to users, ensure you adhere to the branding guidelines of each provider. The use of this API should comply with National Payments Corporation of India (NPCI) and National Electronic Toll Collection (NETC) regulations. Ensure your application maintains proper data privacy practices when handling user FASTag information.

{ "data": { "provider_name": [ "au_bank", "axis_bank", "canara_bank", "union_bank_of_india", "uco_bank", "federal_bank_-", "airtel_payments_bank_netc", "indian_bank_recharge", "idfc_first_bank", "equitas_recharge", "iob", "karnataka_bank", "hdfc_bank", "yes_bank", "bajaj_pay", "bank_of_baroda", "jammu_and_kashmir_bank", "indusind_bank", "idbi_bank", "indian_highways_management_company_ltd", "livquik_technology_india_private_limited", "state_bank_of_india_netc", "icici_bank", "south_indian_bank", "bandhan_bank", "bank_of_maharashtra", "kotak_mahindra_bank" ] }, "status_code": 200, "message_code": "success", "message": "Success", "success": true }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Get Provider List

Get Provider List#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Get Provider List

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples