Skip to main content
GET
Find the fastest route between coordinates in order

Authorizations

Authorization
string
header
required

API key created in the JustRouting dashboard.

Path Parameters

profile
enum<string>
required

Vehicle profile. driving for cars, motorcycle for motorcycles.

Available options:
driving,
motorcycle
coordinates
string
required

Semicolon-separated {lng},{lat} pairs, up to 100, visited in order. All coordinates must be in the same country.

Query Parameters

overview
enum<string>
default:simplified

How much route geometry to return.

Available options:
full,
simplified,
false,
by_legs
steps
boolean
default:false

Return turn-by-turn steps.

alternatives
string

true for one alternative, or a number for up to that many (not guaranteed).

geometries
enum<string>
default:polyline

Geometry encoding of the response.

Available options:
polyline,
polyline6,
geojson
annotations
string

Per-coordinate metadata: true, or a comma list of distance, duration, speed, weight, nodes, datasources.

continue_straight
enum<string>
default:default

Force straight continuation at waypoints, constraining U-turns.

Available options:
default,
true,
false
bearings
string

{bearing},{range};... per coordinate, e.g. 0,20 = north ±20°.

radiuses
string

Snapping radius in meters per coordinate, or unlimited.

hints
string

Base64 hints from a previous response to speed up snapping.

exclude
string

Road classes to avoid (additive list), e.g. motorway.

approaches
string

Restrict the road direction at each waypoint: curb / opposite / unrestricted (default), e.g. curb;opposite.

snapping
enum<string>
default:default

default avoids edges that cannot be used as start/end points; any snaps to any edge in the graph.

Available options:
default,
any
generate_hints
boolean
default:true

Add a hint to response waypoints for reuse in later requests.

skip_waypoints
boolean
default:false

Remove waypoints from the response (still calculated, not serialized).

waypoints
string

Indices of input coordinates to treat as waypoints in the response, e.g. 0;3. Default is all input coordinates.

Response

Route found

code
enum<string>
Available options:
Ok
data_version
string

Timestamp of the OSM data used.

routes
object[]
waypoints
object[]