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>",
    "electric": true
  },
  "car": {},
  "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,
    "pickup": {
      "address": "<string>",
      "lat": 123,
      "lng": 123,
      "place_id": "<string>"
    },
    "delivery": {
      "address": "<string>",
      "lat": 123,
      "lng": 123,
      "place_id": "<string>"
    }
  }
}

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 (adresse / coordonnées selon le relai).

delivery
requis

Point de livraison.

vehicle
object

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

car
object

Alias de vehicle.

plateau
boolean

Transport sur plateau.

options
string[]
return_trip

Caractéristiques du trajet retour (alias returnTrip).

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 du transport (prix client).

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.