Get Toll Price Details

Endpoint Overview

POST /api/v1/nhai/toll-price-details

Description

The NHAI Toll Price Details API provides comprehensive toll rate information for specific toll plazas across Indian states. This endpoint delivers detailed pricing structures for various vehicle categories, including different journey types such as single trips, return journeys, monthly passes, and special rates for commercial vehicles registered within the district. The API serves as the definitive source for accurate toll cost calculations, enabling precise route planning and expense forecasting.

This endpoint is essential for applications requiring exact toll calculations based on vehicle type and journey specifications. It provides the granular pricing data needed for sophisticated transportation cost analysis, supporting everything from individual trip planning to large-scale fleet management operations with accurate, up-to-date toll rate information directly from NHAI sources.

Key Benefits

Comprehensive Vehicle Coverage: Get toll rates for all vehicle categories from cars to heavy commercial multi-axle vehicles

Multiple Journey Types: Access pricing for single journeys, return trips, monthly passes, and district-registered commercial vehicles

Precise Cost Calculation: Enable accurate toll expense forecasting with official NHAI rate structures

Real-Time Rate Access: Retrieve current toll rates directly from authoritative NHAI data sources

Use Cases

Logistics & Transportation

Travel & Tourism

Financial & Business Services

Fleet Cost Management: Calculate exact toll expenses for different vehicle types in fleet operations

Route Cost Analysis: Compare toll costs across different routes and vehicle categories for optimization

Monthly Pass Planning: Determine cost-effectiveness of monthly passes versus per-trip charges for frequent routes

Commercial Vehicle Operations: Access discounted rates for vehicles registered within the toll plaza's district

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 API authentication (JWT format)
Content-Type	Yes	Must be set to application/json

Request Body

Parameter	Type	Required	Description
state_name	String	Yes	The state identifier where the toll plaza is located (e.g., "uttarakhand")
toll_plaza_name	String	Yes	The name of the specific toll plaza for which rates are requested (e.g., "bahadrabad")

Example Request

{
    "state_name": "uttarakhand",
    "toll_plaza_name": "bahadrabad"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container object holding the response data
data.client_id	String	Unique client identifier for tracking and audit purposes
data.state_name	String	Echoed state name from the request for confirmation
data.toll_plaza_name	String	Echoed toll plaza name from the request for confirmation
data.car_toll_rate	Object	Toll rates for passenger cars
data.lcv_toll_rate	Object	Toll rates for Light Commercial Vehicles (LCV)
data.bus_toll_rate	Object	Toll rates for buses
data.three_axle_vehicle_toll_rate	Object	Toll rates for three-axle commercial vehicles
data.four_to_six_axle_toll_rate	Object	Toll rates for four to six axle heavy commercial vehicles
data.seven_or_more_axle_toll_rate	Object	Toll rates for seven or more axle heavy commercial vehicles
data.hcm_eme_toll_rate	Object	Toll rates for Heavy Construction Machinery/Earth Moving Equipment
status_code	Number	HTTP status code indicating request success/failure
success	Boolean	Flag indicating overall request success status
message	String	Human-readable response message (null on success)
message_code	String	Internal status code for programmatic handling

Vehicle Rate Structure

Each vehicle toll rate object contains the following pricing options:

Rate Type	Description
single_journey	One-way toll charge in INR
return_journey	Round-trip toll charge in INR (typically discounted)
monthly_pass	Monthly unlimited pass cost in INR
commercial_vehicle_reg_in_district	Special discounted rate for commercial vehicles registered in the toll plaza's district

Example Successful Response

{
    "data": {
        "client_id": "toll_price_details_scsZzuIttoxDgZIttjRk",
        "state_name": "uttarakhand",
        "toll_plaza_name": "bahadrabad",
        "car_toll_rate": {
            "single_journey": "130",
            "return_journey": "195",
            "monthly_pass": "4325",
            "commercial_vehicle_reg_in_district": "65"
        },
        "lcv_toll_rate": {
            "single_journey": "210",
            "return_journey": "315",
            "monthly_pass": "6990",
            "commercial_vehicle_reg_in_district": "105"
        },
        "bus_toll_rate": {
            "single_journey": "440",
            "return_journey": "660",
            "monthly_pass": "14645",
            "commercial_vehicle_reg_in_district": "220"
        },
        "three_axle_vehicle_toll_rate": {
            "single_journey": "480",
            "return_journey": "720",
            "monthly_pass": "15975",
            "commercial_vehicle_reg_in_district": "240"
        },
        "four_to_six_axle_toll_rate": {
            "single_journey": "690",
            "return_journey": "1035",
            "monthly_pass": "22960",
            "commercial_vehicle_reg_in_district": "345"
        },
        "seven_or_more_axle_toll_rate": {
            "single_journey": "840",
            "return_journey": "1260",
            "monthly_pass": "420",
            "commercial_vehicle_reg_in_district": "27960"
        },
        "hcm_eme_toll_rate": {
            "single_journey": "690",
            "return_journey": "1035",
            "monthly_pass": "345",
            "commercial_vehicle_reg_in_district": "22960"
        }
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid Plaza/State

Authentication Error

Missing Parameters

{
    "status_code": 400,
    "success": false,
    "message": "Invalid toll plaza name or state combination",
    "message_code": "invalid_plaza_state"
}

Occurs when the specified toll plaza doesn't exist in the given state or when incorrect naming conventions are used. Verify plaza and state names against available options.

Integration Best Practices

Security Recommendations

Secure Token Storage: Store JWT tokens in secure, encrypted storage and implement automatic refresh mechanisms

HTTPS Enforcement: Always use HTTPS for API communications to protect sensitive toll rate and financial data

Input Sanitization: Validate and sanitize state and plaza names before API calls to prevent injection attacks

Rate Limiting: Implement intelligent rate limiting to respect API quotas while ensuring optimal performance

User Experience Guidelines

Smart Caching: Cache toll rate data with appropriate TTL as rates change infrequently, improving response times

Vehicle Type Selection: Provide clear vehicle categorization guides to help users select appropriate rate structures

Cost Comparison Tools: Display rate comparisons between different journey types to help users make informed decisions

Error Recovery: Implement graceful error handling with helpful suggestions for resolving invalid plaza/state combinations

Code Samples

cURL

Python

Node.js

Related APIs

Get Toll Plaza States: Retrieve the list of available states to identify valid state parameters

Get Toll Plaza Names: Access toll plaza names within a specific state for accurate plaza identification

Route Toll Calculator: Calculate total toll costs for multi-plaza routes using individual plaza rates

Vehicle Classification Guide: Access detailed vehicle category definitions for accurate rate selection

Compliance and Legal Considerations

This API provides official NHAI toll rates that are subject to government regulations and periodic updates. Users should ensure compliance with Indian transportation laws and NHAI policies when using this toll rate data. The rates returned are current as of the API call and should be used for accurate financial planning and expense calculations. Commercial vehicle discount rates apply only to vehicles properly registered within the toll plaza's administrative district and require appropriate documentation for validation. All toll rates are in Indian Rupees (INR) and should be used in accordance with NHAI's terms of service.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/nhai/toll-price-details' \ --header 'Content-Type: application/json' \ --data-raw '{ "state_name": "uttarakhand", "toll_plaza_name": "bahadrabad" }'

{ "data": { "client_id": "toll_price_details_scsZzuIttoxDgZIttjRk", "state_name": "uttarakhand", "toll_plaza_name": "bahadrabad", "car_toll_rate": { "single_journey": "130", "return_journey": "195", "monthly_pass": "4325", "commercial_vehicle_reg_in_district": "65" }, "lcv_toll_rate": { "single_journey": "210", "return_journey": "315", "monthly_pass": "6990", "commercial_vehicle_reg_in_district": "105" }, "bus_toll_rate": { "single_journey": "440", "return_journey": "660", "monthly_pass": "14645", "commercial_vehicle_reg_in_district": "220" }, "three_axle_vehicle_toll_rate": { "single_journey": "480", "return_journey": "720", "monthly_pass": "15975", "commercial_vehicle_reg_in_district": "240" }, "four_to_six_axle_toll_rate": { "single_journey": "690", "return_journey": "1035", "monthly_pass": "22960", "commercial_vehicle_reg_in_district": "345" }, "seven_or_more_axle_toll_rate": { "single_journey": "840", "return_journey": "1260", "monthly_pass": "420", "commercial_vehicle_reg_in_district": "27960" }, "hcm_eme_toll_rate": { "single_journey": "690", "return_journey": "1035", "monthly_pass": "345", "commercial_vehicle_reg_in_district": "22960" } }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Toll Price Details

Get Toll Price Details#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Vehicle Rate Structure#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses