Get toll cost information for route

You can get toll cost information by including tolls in the return parameter. This information is available for the following transport modes:

• car
• truck
• taxi
• bus

Each section of the route will contain a list of applicable tolls, with their names, payment methods, prices in local currencies and, if applicable, converted prices in requested currency. The granularity of the toll costs can span from the entire route (in case of vignette) to individual road segments (in case of pay-per-km truck tolls).

Depending on the toll system, toll prices may differ based on the payment method, vehicle characteristics, time of passage and other factors. Vehicle characteristics can be specified (to some extent) with transportMode, vehicle[hovOccupancy] and, in truck mode, with truck profile. Specify the departure time to calculate the time of passage from ETA. Due to the complexity of various toll systems, the prices are provided on a best-effort basis.

You can request currency conversion of the toll prices by including the currency three-letter code, such as currency=USD.

This is a request for tolls in USD for a route through a tunnel that is billed based on the time of passage and vehicle height:

curl -X GET \
'https://router.hereapi.com/v8/routes?origin=51.307986,4.327722&destination=51.282912,4.286618&return=tolls&transportMode=truck&vehicle[height]=310&departureTime=2021-01-01T21:00:00&currency=USD&apikey={YOUR_API_KEY}'

{
  "routes": [
    {
      "id": "395379a4-2db7-485e-ad10-911ffce911cf",
      "sections": [
        {
          "id": "700c42a0-a981-4817-a250-74037c7699ba",
          "type": "vehicle",
          "departure": {
            "time": "2021-01-01T21:00:00+01:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 51.3079803,
                "lng": 4.3277143
              },
              "originalLocation": {
                "lat": 51.307986,
                "lng": 4.3277219
              }
            }
          },
          "arrival": {
            "time": "2021-01-01T21:06:15+01:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 51.2828957,
                "lng": 4.286669
              },
              "originalLocation": {
                "lat": 51.2829119,
                "lng": 4.2866179
              }
            }
          },
          "transport": {
            "mode": "truck"
          },
          "tolls": [
            {
              "countryCode": "BEL",
              "tollSystem": "LIEFKENSHOEKTUNNEL",
              "fares": [
                {
                  "id": "26051851-9c7f-4635-933f-bd3022c1743e",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 14.16
                  },
                  "convertedPrice": {
                    "type": "value",
                    "currency": "USD",
                    "value": 17.08
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "transponder"
                  ]
                },
                {
                  "id": "7ee701ba-5967-4236-aa74-38deb0cc063c",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 19
                  },
                  "convertedPrice": {
                    "type": "value",
                    "currency": "USD",
                    "value": 22.91
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "cash"
                  ]
                },
                {
                  "id": "266bfb58-9114-4254-a785-7b1941a6383d",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 17.6
                  },
                  "convertedPrice": {
                    "type": "value",
                    "currency": "USD",
                    "value": 21.23
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "bankCard",
                    "creditCard",
                    "travelCard"
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}