POST
/
pricing
Estimer un prix
curl --request POST \
  --url https://sandbox.myexpressdriver.com/v1/pricing \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "pickup": "<string>",
  "delivery": "<string>",
  "vehicle": {
    "type": "<string>",
    "registration": "<string>",
    "vin": "<string>",
    "brand": "<string>",
    "model": "<string>",
    "electric": false
  },
  "car": {
    "type": "<string>",
    "registration": "<string>",
    "vin": "<string>",
    "brand": "<string>",
    "model": "<string>",
    "electric": false
  },
  "plateau": true,
  "options": [
    "<string>"
  ],
  "return_trip": true,
  "billing": {}
}
'
{
  "price_ht": 123,
  "currency": "<string>",
  "distance_km": 123,
  "pickup": {
    "address": "<string>",
    "lat": 123,
    "lng": 123,
    "place_id": "<string>"
  },
  "delivery": {
    "address": "<string>",
    "lat": 123,
    "lng": 123,
    "place_id": "<string>"
  },
  "return_trip": {
    "price_ht": 123,
    "distance_km": 123,
    "tariffs": {
      "vp": {
        "price_ht": 123,
        "plateau_ht": 123
      },
      "vu": {
        "price_ht": 123,
        "plateau_ht": 123
      },
      "vul": {
        "price_ht": 123,
        "plateau_ht": 123
      }
    },
    "pickup": {
      "address": "<string>",
      "lat": 123,
      "lng": 123,
      "place_id": "<string>"
    },
    "delivery": {
      "address": "<string>",
      "lat": 123,
      "lng": 123,
      "place_id": "<string>"
    }
  },
  "tariffs": {
    "vp": {
      "price_ht": 123,
      "plateau_ht": 123
    },
    "vu": {
      "price_ht": 123,
      "plateau_ht": 123
    },
    "vul": {
      "price_ht": 123,
      "plateau_ht": 123
    }
  }
}

Autorisations

X-Api-Key
string
header
requis

Clé API liée à un groupe (med_live_… en production, med_test_… en test). Fournie en clair une seule fois à la création depuis le profil client.

En-têtes

Idempotency-Key
string

Clé d'idempotence fournie par le client. Rejouer la même clé avec un body identique renvoie la réponse en cache (Idempotent-Replayed: true). La même clé avec un body différent renvoie 409.

Corps

application/json

Requête d'estimation tarifaire.

pickup
requis

Point d'enlèvement. Une chaîne (adresse) suffit pour estimer, ou un objet pour plus de détails.

delivery
requis

Point de livraison (même format que pickup).

vehicle
object

Caractéristiques du véhicule (alias car).

car
object

Alias de vehicle.

plateau
boolean

Transport sur plateau.

options
string[]
return_trip

Trajet retour (alias returnTrip). true = A→B→A (retour au point d'enlèvement de l'aller) ; une chaîne = A→B→C (adresse de destination du retour) ; un objet = forme complète. Le départ du retour est toujours la livraison de l'aller (B).

billing
object

Informations de facturation simplifiées (optionnel pour l'estimation).

Réponse

Estimation tarifaire.

Résultat de l'estimation tarifaire (prix CLIENT uniquement).

price_ht
number | null
requis

Prix HT CLIENT pour le véhicule demandé — gabarit effectivement retenu (déduit de l'immatriculation : VP/VU/VUL), options, plaque W, suppléments et plateau inclus si demandés. C'est le tarif de référence à facturer. Il peut donc différer de tariffs.vp (voir tariffs).

currency
string
requis

Devise (toujours EUR).

distance_km
number | null
requis

Distance routière estimée, en kilomètres.

pickup
object
requis

Adresse d'enlèvement RÉSOLUE (géocodée) — confirmez le match.

delivery
object
requis

Adresse de livraison RÉSOLUE (géocodée).

return_trip
object
requis

Détail du trajet retour si demandé, sinon null.

tariffs
object

Tarifs TRANSPORT par gabarit VP/VU/VUL (options/suppléments/plateau EXCLUS), pour comparer les gabarits. Indépendant de price_ht (qui, lui, inclut le gabarit demandé + options + suppléments).