# On va où ? Routing API

> Routing API built for two-wheelers and wheelchairs: bike, e-bike, kick scooter, motorcycle, wheelchair and walking. One request returns up to three route variants (safe, balanced, fast) with the share of cycle lanes, unpaved surfaces and main roads, elevation profile and turn-by-turn steps. Monthly plans from 0 € (10,000 requests) with self-service API keys. Made in France by On va où ? (OVO SAS).

The same engine powers the « On va où ? » navigation and safety app (iOS and Android, 30 languages).

## Why developers pick it

- Three variants per request, billed as ONE request: `safe` favours cycle lanes and quiet streets (for motorcycles: avoids motorways), `balanced` and `fast`.
- Route quality indicators in every response: cycleway share, unpaved share, main-road share, motorway share, ascent and descent.
- Dedicated profiles: bike, e-bike, kick scooter, motorcycle (with toll and motorway avoidance), wheelchair (slope, surface and kerb aware), walking.
- Self-service: create an account and API keys in minutes at https://console.onvaou.app, free plan without a credit card.
- Coverage: all of Europe on every plan, free plan included. EU-hosted service, OpenStreetMap data.

## Pricing (EUR, excl. VAT, monthly, no commitment)

- Découverte (free): 10,000 requests/month, 1 req/s, non-commercial use.
- Solo: 19 €/month, 20,000 requests, 2 req/s, commercial use, overage 1.00 € per 1,000.
- Starter: 59 €/month, 75,000 requests, 3 req/s, commercial use, overage 0.90 € per 1,000.
- Pro: 169 €/month, 225,000 requests, 10 req/s, overage 0.80 € per 1,000.
- Business: 449 €/month, 750,000 requests, 25 req/s, overage 0.65 € per 1,000, priority support.
- Failed calculations are never counted. Identical requests within 24 hours are served from cache.
- Custom: above 750,000 requests/month, coverage outside Europe, dedicated instance.

## Quick start

1. Create an account and a key: https://console.onvaou.app
2. Call the API with the key in the `x-api-key` header:

```
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"}'
```

## Docs

- [Routing API reference (English)](https://onvaou.app/developers/routing-api.html): parameters, response, errors, pricing
- [Documentation de l’API Itinéraires (français)](https://onvaou.app/developpeurs/api-itineraires.html)
- [OpenAPI 3.1 specification](https://onvaou.app/openapi/api-itineraires.yaml)
- [Developer portal: account, keys, subscription](https://console.onvaou.app)
- [Offer page (French)](https://onvaou.app/api/itineraires)

## Optional

- [HR API (French)](https://onvaou.app/api/rh): monthly GPS-proven bike and scooter commute days and certificates for payroll, benefits platforms and HR systems (sustainable mobility allowance, France). Sold on quote.
- [Contact](https://onvaou.app/contact?sujet=api)