---
title: "Itinéraire routier en voiture : distance et durée entre deux adresses ou coordonnées"
method: GET
path: "/v1/routes"
tags: ["B2B (v1)"]
---

# Itinéraire routier en voiture : distance et durée entre deux adresses ou coordonnées

`GET /v1/routes`

## Request

- Base URL: `https://api.vitef.com`
- URL: `https://api.vitef.com/v1/routes`
- Auth: HTTP bearer

## Query parameters

- `from` string, required: Adresse (géocodée par Addok) ou « lon,lat ».
- `to` string, required
- `geometry` 'true' | 'false': `true` : ajoute le tracé simplifié de l’itinéraire (pour une carte).

## Response `200`

Itinéraire

- RouteResult
  - `distanceKm` number, required
  - `durationMin` integer, required
  - `from` GeoPoint, required
    - `lat` number, required
    - `lon` number, required
    - `label` string, required
  - `to` GeoPoint, required
    - `lat` number, required
    - `lon` number, required
    - `label` string, required
  - `geometry` array[]: Tracé simplifié : points [lon, lat] (avec `geometry=true`).
    - number[]

## Other responses

- `400`: Requête invalide
- `401`: Authentification requise ou invalide
- `402`: Crédits ou paiement requis
- `403`: Accès refusé (`insufficient_scope`, `account_suspended`, `live_not_enabled`)
- `404`: Ressource introuvable
- `429`: Trop de requêtes
- `500`: Erreur interne
- `502`: Service partenaire en erreur

---

[API](https://skmtc.dev/vitef/apis/api-vitef.md) · [All operations](https://skmtc.dev/vitef/apis/api-vitef/llms.txt) · [OpenAPI document](https://skmtc.dev/vitef/apis/api-vitef/revisions/7bc459d9ef90?raw)