On va où ?API

Routing API for bikes, scooters, motorcycles and wheelchairs

The routing engine of the « On va où ? » navigation and safety app, for your own products. One request returns up to three variants, safe, balanced and fast, billed as a single request, with what makes a two-wheel route good or bad: cycle lanes, surfaces, main roads, elevation.

Get a free API key Pricing OpenAPI spec

Why this API

Quick start

Create an account and a key at console.onvaou.app, then send the key in the x-api-key header. Call the API from your server, never from a web page or a mobile app.

curl -X POST https://n3di1oyh9d.execute-api.eu-west-1.amazonaws.com/v1/routes \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":[2.3522,48.8566],"destination":[2.4392,48.8474],"mode":"bike"}'

Request: POST /v1/routes

FieldTypeDescription
origin, destination[lon, lat]Required, WGS 84.
waypoints[[lon, lat]]Up to 8 intermediate points.
modestringbike (default), ebike, scooter (kick scooter), moto (motorcycle), wheelchair, foot.
variantsstring[]Any of safe, balanced, fast. Default: all three.
avoidstring[]ferries, steps; tolls, highways (motorcycle); unpaved, steep (wheelchair).
elevationbooleanElevation profile, default true.
instructionsbooleanTurn-by-turn steps, default true.
languagestringfr (default), en, de, es, it, nl, pt.
geometrystringgeojson (default) or polyline (Google algorithm, precision 5).

Response

{
  "mode": "bike",
  "routes": [
    {
      "variants": ["safe", "balanced", "fast"],
      "distanceM": 7159,
      "durationS": 1525,
      "ascentM": 38,
      "descentM": 41,
      "indicators": { "cyclewayShare": 0.773, "unpavedShare": 0, "mainRoadShare": 0.036, "motorwayShare": 0 },
      "geometry": { "type": "LineString", "coordinates": [[2.3522, 48.8566], "..."] },
      "elevationProfile": [[0, 35], [95, 36], "..."],
      "steps": [{ "instruction": "Head east", "name": "Quai de l'Hôtel de Ville", "distanceM": 120, "durationS": 28, "type": 11 }]
    }
  ],
  "usage": { "month": "2026-09", "requests": 1, "quota": 10000, "plan": "decouverte" },
  "attribution": "© On va où ? · © openrouteservice by HeiGIT · © OpenStreetMap contributors"
}

When the engine finds a single sensible route, it is returned once with all the requested labels. Variants are never invented. Display the attribution next to the route you show.

Errors

StatusCodeMeaning
400bad_*, too_longInvalid request (message explains the field).
401invalid_keyMissing, unknown or revoked key.
422no_route, out_of_coverageNo route between these points for this vehicle, or a point outside Europe.
429quota_exceededFree plan quota reached for the month.
503engine_capacity, engine_unavailableTemporary, retry later.

Pricing

Monthly subscription, no commitment, prices in euros excluding VAT. Every plan includes every feature; only volume, rate and commercial use change. One request = one route calculation returning up to three variants.

PlanPrice / monthRequests / monthRateOverage / 1,000
Découverte0 €10,0001 req/sblocked (non-commercial)
Solo19 €20,0002 req/s1.00 €
Starter59 €75,0003 req/s0.90 €
Pro169 €225,00010 req/s0.80 €
Business449 €750,00025 req/s0.65 €
Customquoteabove 750,000dedicatedcoverage outside Europe, SLA

Subscribe and manage your plan at console.onvaou.app. Card payment by Stripe.

FAQ

Is there a free plan?

Yes: 10,000 requests per month for development and non-commercial use, without a credit card.

Can I use it in a commercial app?

Yes, from the Solo plan (19 € per month). Show the attribution next to the displayed route (OpenStreetMap data).

Which area is covered?

All of Europe, on every plan. For other regions, contact us (Custom plan). Points outside the coverage return 422 out_of_coverage.

Which vehicles are supported?

Bike, e-bike, kick scooter, motorcycle, wheelchair and walking, each with its own profile.

How is the safe variant chosen?

For bikes and scooters, it is the route with the highest share of cycle lanes and the fewest main roads among the alternatives. For motorcycles, it is computed avoiding motorways.