Directions
Route between two or more points
Calculates a route across the Rwandan road network, honouring terrain, surface and engine-supported access restrictions. Published local road operations are not yet served.
Cost: 1 credit for up to 10 waypoints, plus 1 credit for each additional 10.
apiKeyAuthorizationBearer <token>Send your key as Authorization: Bearer sk_live_….
Secret keys (sk_) are for server-side use and must never be exposed in a browser or a
mobile binary. Browser or mobile use of secret keys is unsupported. Use your server to call these endpoints.
application/json- body
coordinates*array<array<any>>Waypoints in visiting order, starting with the origin.
2 <= items <= 50profile?ProfileThe vehicle and behaviour model used for costing. moto is the motorcycle-taxi profile and
the one most Rwandan traffic actually uses.
"car""moto""moto""car""truck""bicycle""pedestrian""pedestrian_loaded"departure_time?stringDeparture time. Supplying it applies time-conditioned restrictions such as bus lanes and market-day closures. Defaults to now.
date-time"2026-09-02T07:15:00+02:00"alternatives?integerNumber of alternative routes to return in addition to the best one.
0 <= value <= 31geometry_format?stringEncoding of the returned route geometry.
"polyline6""polyline6""geojson"include_steps?booleanInclude turn-by-turn maneuver steps in each route leg.
falseA route was found.
application/json- response
Fields present on every successful response.
request_id*stringUnique id for this request. Quote it in any support conversation.
length <= 64"req_01JBQ7Z9Y4K2M3N4P5Q6R7S8T9"credits_charged*integerCredits deducted from the account balance for this request.
0 <= value1data_version*stringThe data release that answered this request.
length <= 32"2026-09-02T03"profile*ProfileThe vehicle and behaviour model used for costing. moto is the motorcycle-taxi profile and
the one most Rwandan traffic actually uses.
"car""moto""moto""car""truck""bicycle""pedestrian""pedestrian_loaded"routes*array<>Best route first, followed by requested alternatives.
1 <= items <= 4curl -X POST 'https://api.uat.audisory.com/v1/directions' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "coordinates": [ [ 30.0619, -1.9441 ], [ 30.1395, -1.9686 ] ], "profile": "moto"}'{ "request_id": "req_01JBQ7Z9Y4K2M3N4P5Q6R7S8T9", "credits_charged": 1, "data_version": "2026-09-02T03", "profile": "moto", "routes": [ { "id": 0, "summary": { "distance_m": 12480, "duration_s": 1320 }, "elevation": { "ascent_m": 142, "descent_m": 38, "max_grade": 0.09 }, "traffic_confidence": "low", "geometry": "zpq}Ao~ihE...", "legs": [ { "distance_m": 12480, "duration_s": 1320 } ] } ]}