# Routing API

> Routing API on Apizie: 4 endpoints (Reachable Range, Reachable Range, Calculate Route, Calculate Route) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/places:tomtom-routing/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `places:tomtom-routing`
- Category: Places
- Status: byok
- Source: https://developer.tomtom.com/contact-us
- Page: https://www.apizie.tech/api/places/tomtom-routing
- OpenAPI: https://www.apizie.tech/api/places/tomtom-routing/openapi.json

Routing consists of the following service: Calculate Route Calculates a route between an origin and a destination, passing through waypoints (if specified). Additional routing parameters like traffic, avoidance…

## Endpoints

### Reachable Range
`GET https://www.apizie.tech/v1/places:tomtom-routing/get-routing-version-number-calculate-reachable-range-origin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Service version number. The current value is 1. |
| origin | string | yes | Point from which the range calculation should start. |
| contentType | string | yes | The content type of the response structure. If the content type is jsonp, a callback method can be specified in the query parameters. |
| fuelBudgetInLiters | number | no | Fuel budget in liters. Determines the maximum vehicle range using the specified Combustion Consumption Model. |
| energyBudgetInkWh | number | no | Electric energy budget in kilowatt hours (kWh). Determines the maximum vehicle range using the specified Electric Consumption Model. |
| timeBudgetInSec | number | no | Time budget in seconds. Determines the maximum vehicle range using the specified driving time. The consumption parameters in the request… |
| callback | string | no | Specifies the jsonp callback method. |
| report | string | no | Specifies which data should be reported for diagnosis purposes. |
| departAt | string | no | The date and time of departure from the origin point. Departure times apart from now must be specified as a dateTime. |
| arriveAt | string | no | The date and time of arrival at the destination point. It must be specified as a dateTime. |
| routeType | string | no | The type of route requested. |
| traffic | boolean | no | Determines whether current traffic is used in route calculations. Note that information on historic road speeds is always used. |
| avoid | string | no | Specifies whether the routing engine should try to avoid specific types of road segment when calculating the route. Can be specified… |
| travelMode | string | no | The mode of travel for the requested route. |
| hilliness | string | no | Degree of hilliness for calculating a thrilling route. |
| windingness | string | no | Amount that a thrilling route should wind. |
| vehicleMaxSpeed | integer | no | Maximum speed of the vehicle in km/hour. |
| vehicleWeight | integer | no | Weight of the vehicle in kilograms. |
| vehicleAxleWeight | integer | no | Weight per axle of the vehicle in kg. |
| vehicleLength | number | no | Length of the vehicle in meters. |
| vehicleWidth | number | no | Width of the vehicle in meters. |
| vehicleHeight | number | no | Height of the vehicle in meters. |
| vehicleCommercial | boolean | no | Indicates that the vehicle is used for commercial purposes. This means it may not be allowed on certain roads. |
| vehicleLoadType | string | no | Indicates what kinds of hazardous materials the vehicle is carrying (if any). This means it may not be allowed on certain roads. Use these… |
| constantSpeedConsumptionInLitersPerHundredkm | string | no | Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate pairs. |
| currentFuelInLiters | number | no | Specifies the current supply of fuel in liters. |
| auxiliaryPowerInLitersPerHour | number | no | Specifies the amount of fuel consumed for sustaining auxiliary systems of the vehicle, in liters per hour. |
| fuelEnergyDensityInMJoulesPerLiter | number | no | Specifies the amount of chemical energy stored in one liter of fuel in megajoules (MJ). |
| accelerationEfficiency | number | no | Specifies the efficiency of converting chemical energy stored in fuel to kinetic energy when the vehicle accelerates (i.e.… |
| decelerationEfficiency | number | no | Specifies the efficiency of converting kinetic energy to saved (not consumed) fuel when the vehicle decelerates (i.e.… |
| uphillEfficiency | number | no | Specifies the efficiency of converting chemical energy stored in fuel to potential energy when the vehicle gains elevation (i.e.… |
| downhillEfficiency | number | no | Specifies the efficiency of converting potential energy to saved (not consumed) fuel when the vehicle loses elevation (i.e.… |
| vehicleEngineType | string | no | Engine type of the vehicle. |
| constantSpeedConsumptionInkWhPerHundredkm | string | no | Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate pairs. |

### Reachable Range
`POST https://www.apizie.tech/v1/places:tomtom-routing/post-routing-version-number-calculate-reachable-range-origin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Service version number. The current value is 1. |
| origin | string | yes | Point from which the range calculation should start. |
| contentType | string | yes | The content type of the response structure. If the content type is jsonp, a callback method can be specified in the query parameters. |
| fuelBudgetInLiters | number | no | Fuel budget in liters. Determines the maximum vehicle range using the specified Combustion Consumption Model. |
| energyBudgetInkWh | number | no | Electric energy budget in kilowatt hours (kWh). Determines the maximum vehicle range using the specified Electric Consumption Model. |
| timeBudgetInSec | number | no | Time budget in seconds. Determines the maximum vehicle range using the specified driving time. The consumption parameters in the request… |
| callback | string | no | Specifies the jsonp callback method. |
| report | string | no | Specifies which data should be reported for diagnosis purposes. |
| departAt | string | no | The date and time of departure from the origin point. Departure times apart from now must be specified as a dateTime. |
| arriveAt | string | no | The date and time of arrival at the destination point. It must be specified as a dateTime. |
| routeType | string | no | The type of route requested. |
| traffic | boolean | no | Determines whether current traffic is used in route calculations. Note that information on historic road speeds is always used. |
| avoid | string | no | Specifies whether the routing engine should try to avoid specific types of road segment when calculating the route. Can be specified… |
| travelMode | string | no | The mode of travel for the requested route. |
| hilliness | string | no | Degree of hilliness for calculating a thrilling route. |
| windingness | string | no | Amount that a thrilling route should wind. |
| vehicleMaxSpeed | integer | no | Maximum speed of the vehicle in km/hour. |
| vehicleWeight | integer | no | Weight of the vehicle in kilograms. |
| vehicleAxleWeight | integer | no | Weight per axle of the vehicle in kg. |
| vehicleLength | number | no | Length of the vehicle in meters. |
| vehicleWidth | number | no | Width of the vehicle in meters. |
| vehicleHeight | number | no | Height of the vehicle in meters. |
| vehicleCommercial | boolean | no | Indicates that the vehicle is used for commercial purposes. This means it may not be allowed on certain roads. |
| vehicleLoadType | string | no | Indicates what kinds of hazardous materials the vehicle is carrying (if any). This means it may not be allowed on certain roads. Use these… |
| constantSpeedConsumptionInLitersPerHundredkm | string | no | Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate pairs. |
| currentFuelInLiters | number | no | Specifies the current supply of fuel in liters. |
| auxiliaryPowerInLitersPerHour | number | no | Specifies the amount of fuel consumed for sustaining auxiliary systems of the vehicle, in liters per hour. |
| fuelEnergyDensityInMJoulesPerLiter | number | no | Specifies the amount of chemical energy stored in one liter of fuel in megajoules (MJ). |
| accelerationEfficiency | number | no | Specifies the efficiency of converting chemical energy stored in fuel to kinetic energy when the vehicle accelerates (i.e.… |
| decelerationEfficiency | number | no | Specifies the efficiency of converting kinetic energy to saved (not consumed) fuel when the vehicle decelerates (i.e.… |
| uphillEfficiency | number | no | Specifies the efficiency of converting chemical energy stored in fuel to potential energy when the vehicle gains elevation (i.e.… |
| downhillEfficiency | number | no | Specifies the efficiency of converting potential energy to saved (not consumed) fuel when the vehicle loses elevation (i.e.… |
| vehicleEngineType | string | no | Engine type of the vehicle. |
| constantSpeedConsumptionInkWhPerHundredkm | string | no | Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate pairs. |
| body | object | no | JSON request body |

### Calculate Route
`GET https://www.apizie.tech/v1/places:tomtom-routing/get-routing-version-number-calculate-route-locations-content` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Service version number. The current value is 1. |
| locations | string | yes | Locations through which the calculated route must pass. |
| contentType | string | yes | The content type of the response structure. If the content type is jsonp, a callback method can be specified in the query parameters. |
| maxAlternatives | integer | no | Number of alternative routes to be calculated. |
| alternativeType | string | no | Determines whether the alternative routes to be calculated should be better with respect to the planning criteria provided than the… |
| minDeviationDistance | integer | no | All alternative routes will follow the reference route for the specified minimum number of meters starting from the origin point. |
| minDeviationTime | integer | no | All alternative routes will follow the reference route for the specified minimum number of seconds starting from the origin point. |
| instructionsType | string | no | If specified, guidance instructions will be returned (if available). |
| language | string | no | The language parameter determines the language of the guidance messages. |
| computeBestOrder | boolean | no | Re-order the route waypoints to reduce the route length. |
| routeRepresentation | string | no | Specifies the representation of the set of routes provided as a response. |
| computeTravelTimeFor | string | no | Specifies whether to return additional travel times using different types of traffic information (none, historic, live) as well as the… |
| vehicleHeading | integer | no | The directional heading of the vehicle in degrees. Entered in degrees, measured clockwise from north (so north is 0, east is 90, etc.). |
| sectionType | string | no | Specifies which section types are explicitly reported in the route response. Can be specified multiple times. - carTrain, ferry, tunnel or… |
| callback | string | no | Specifies the jsonp callback method. |
| report | string | no | Specifies which data should be reported for diagnosis purposes. |
| departAt | string | no | The date and time of departure from the origin point. Departure times apart from now must be specified as a dateTime. |
| arriveAt | string | no | The date and time of arrival at the destination point. It must be specified as a dateTime. |
| routeType | string | no | The type of route requested. |
| traffic | boolean | no | Determines whether current traffic is used in route calculations. Note that information on historic road speeds is always used. |
| avoid | string | no | Specifies whether the routing engine should try to avoid specific types of road segment when calculating the route. Can be specified… |
| travelMode | string | no | The mode of travel for the requested route. |
| hilliness | string | no | Degree of hilliness for calculating a thrilling route. |
| windingness | string | no | Amount that a thrilling route should wind. |
| vehicleMaxSpeed | integer | no | Maximum speed of the vehicle in km/hour. |
| vehicleWeight | integer | no | Weight of the vehicle in kilograms. |
| vehicleAxleWeight | integer | no | Weight per axle of the vehicle in kg. |
| vehicleLength | number | no | Length of the vehicle in meters. |
| vehicleWidth | number | no | Width of the vehicle in meters. |
| vehicleHeight | number | no | Height of the vehicle in meters. |
| vehicleCommercial | boolean | no | Indicates that the vehicle is used for commercial purposes. This means it may not be allowed on certain roads. |
| vehicleLoadType | string | no | Indicates what kinds of hazardous materials the vehicle is carrying (if any). This means it may not be allowed on certain roads. Use these… |
| vehicleEngineType | string | no | Engine type of the vehicle. |
| constantSpeedConsumptionInLitersPerHundredkm | string | no | Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate pairs. |
| currentFuelInLiters | number | no | Specifies the current supply of fuel in liters. |
| auxiliaryPowerInLitersPerHour | number | no | Specifies the amount of fuel consumed for sustaining auxiliary systems of the vehicle, in liters per hour. |
| fuelEnergyDensityInMJoulesPerLiter | number | no | Specifies the amount of chemical energy stored in one liter of fuel in megajoules (MJ). |
| accelerationEfficiency | number | no | Specifies the efficiency of converting chemical energy stored in fuel to kinetic energy when the vehicle accelerates (i.e.… |
| decelerationEfficiency | number | no | Specifies the efficiency of converting kinetic energy to saved (not consumed) fuel when the vehicle decelerates (i.e.… |
| uphillEfficiency | number | no | Specifies the efficiency of converting chemical energy stored in fuel to potential energy when the vehicle gains elevation (i.e.… |
| downhillEfficiency | number | no | Specifies the efficiency of converting potential energy to saved (not consumed) fuel when the vehicle loses elevation (i.e.… |
| constantSpeedConsumptionInkWhPerHundredkm | string | no | Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate pairs. |

### Calculate Route
`POST https://www.apizie.tech/v1/places:tomtom-routing/post-routing-version-number-calculate-route-locations-conten` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Service version number. The current value is 1. |
| locations | string | yes | Locations through which the calculated route must pass. |
| contentType | string | yes | The content type of the response structure. If the content type is jsonp, a callback method can be specified in the query parameters. |
| maxAlternatives | integer | no | Number of alternative routes to be calculated. |
| alternativeType | string | no | Determines whether the alternative routes to be calculated should be better with respect to the planning criteria provided than the… |
| minDeviationDistance | integer | no | All alternative routes will follow the reference route for the specified minimum number of meters starting from the origin point. |
| minDeviationTime | integer | no | All alternative routes will follow the reference route for the specified minimum number of seconds starting from the origin point. |
| instructionsType | string | no | If specified, guidance instructions will be returned (if available). |
| language | string | no | The language parameter determines the language of the guidance messages. |
| computeBestOrder | boolean | no | Re-order the route waypoints to reduce the route length. |
| routeRepresentation | string | no | Specifies the representation of the set of routes provided as a response. |
| computeTravelTimeFor | string | no | Specifies whether to return additional travel times using different types of traffic information (none, historic, live) as well as the… |
| vehicleHeading | integer | no | The directional heading of the vehicle in degrees. Entered in degrees, measured clockwise from north (so north is 0, east is 90, etc.). |
| sectionType | string | no | Specifies which section types are explicitly reported in the route response. Can be specified multiple times. - carTrain, ferry, tunnel or… |
| callback | string | no | Specifies the jsonp callback method. |
| report | string | no | Specifies which data should be reported for diagnosis purposes. |
| departAt | string | no | The date and time of departure from the origin point. Departure times apart from now must be specified as a dateTime. |
| arriveAt | string | no | The date and time of arrival at the destination point. It must be specified as a dateTime. |
| routeType | string | no | The type of route requested. |
| traffic | boolean | no | Determines whether current traffic is used in route calculations. Note that information on historic road speeds is always used. |
| avoid | string | no | Specifies whether the routing engine should try to avoid specific types of road segment when calculating the route. Can be specified… |
| travelMode | string | no | The mode of travel for the requested route. |
| hilliness | string | no | Degree of hilliness for calculating a thrilling route. |
| windingness | string | no | Amount that a thrilling route should wind. |
| vehicleMaxSpeed | integer | no | Maximum speed of the vehicle in km/hour. |
| vehicleWeight | integer | no | Weight of the vehicle in kilograms. |
| vehicleAxleWeight | integer | no | Weight per axle of the vehicle in kg. |
| vehicleLength | number | no | Length of the vehicle in meters. |
| vehicleWidth | number | no | Width of the vehicle in meters. |
| vehicleHeight | number | no | Height of the vehicle in meters. |
| vehicleCommercial | boolean | no | Indicates that the vehicle is used for commercial purposes. This means it may not be allowed on certain roads. |
| vehicleLoadType | string | no | Indicates what kinds of hazardous materials the vehicle is carrying (if any). This means it may not be allowed on certain roads. Use these… |
| vehicleEngineType | string | no | Engine type of the vehicle. |
| constantSpeedConsumptionInLitersPerHundredkm | string | no | Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate pairs. |
| currentFuelInLiters | number | no | Specifies the current supply of fuel in liters. |
| auxiliaryPowerInLitersPerHour | number | no | Specifies the amount of fuel consumed for sustaining auxiliary systems of the vehicle, in liters per hour. |
| fuelEnergyDensityInMJoulesPerLiter | number | no | Specifies the amount of chemical energy stored in one liter of fuel in megajoules (MJ). |
| accelerationEfficiency | number | no | Specifies the efficiency of converting chemical energy stored in fuel to kinetic energy when the vehicle accelerates (i.e.… |
| decelerationEfficiency | number | no | Specifies the efficiency of converting kinetic energy to saved (not consumed) fuel when the vehicle decelerates (i.e.… |
| uphillEfficiency | number | no | Specifies the efficiency of converting chemical energy stored in fuel to potential energy when the vehicle gains elevation (i.e.… |
| downhillEfficiency | number | no | Specifies the efficiency of converting potential energy to saved (not consumed) fuel when the vehicle loses elevation (i.e.… |
| constantSpeedConsumptionInkWhPerHundredkm | string | no | Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate pairs. |
| body | object | no | JSON request body |

## Example
```
curl "https://www.apizie.tech/v1/places:tomtom-routing/get-routing-version-number-calculate-reachable-range-origin" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Routing API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/places:tomtom-routing/get-routing-version-number-calculate-reachable-range-origin with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Routing API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Routing itself also needs your own key from tomtom.com.

### Can AI agents use the Routing API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key places:tomtom-routing.

### What is the status of the Routing API?
Needs your own provider key (bring your own key)