Directions API

Status Codes/Functional Maximums

The following tables describe the error messages that can be returned from an unsuccessful route request. Each function section also lists any functional maximums acceptable for that call.

Directions Service Call

Status Code Description
0 A successful route call.
400 Invalid Request.
401 Invalid Options.
402 Invalid Location.
403 Key-related error.
500 Unknown error
600 Invalid session ID.
601 Session ID expired
602 Baseline failed.
604 Exceeded maximum search time.
605 Exceeded maximum search distance.
606 Exceeded maximum number of locations.
607 Failed to get density for all locations.
608 Exceeded pedestrian maximum gross distance for locations.
609 Exceeded maximum gross distance for locations.
610 Ambiguities detected in locations.
611 At least two locations required
612 No routes available for location.

Route/Optimized Route Call

Status Code Description
601 Invalid location specified.
602 The route failed, normally due to mustAvoidLinkIds options being set in a way that makes the route impossible.
603 No dataset found to calculate the route.
610 Ambiguities were found in one or more of the locations specified and ambiguities=ignore was not set.
Maximum Description
50 Number of locations acceptable.

Route Matrix Call

Status Code Description
601 Invalid location specified.
602 No routes were found.
603 No dataset found to calculate the route.
604 Invalid option was specified.
605 Partial Success.
606 Exceeded maximum locations.
Maximum Description
25 Number of locations acceptable.

Drag Route Call

Status Code Description
601 Invalid location specified.
602 The route failed, normally due to mustAvoidLinkIds options being set in a way that makes the route impossible.
603 No dataset found to calculate the route.
Maximum Description
20 Number of via points acceptable.

Route Shape Call

Status Code Description
601 Invalid session specified.

Path from Route Call

Status Code Description
601 Partial Success
602 Exceeded maximum number of POIs
603 Not Specified
604 Exceeded maximum search time
605 Exceeded maximum search distance
606 Failure
607 No POIs
608 No nodes were found within the supplied corridor limits
Maximum Description
1000 Number of pois.
15 minutes Time to perform search.
10 miles (16 km) Distance to perform search.