Price estimate
What a ride will cost before anyone books it — from the same price list the passenger sees in the app.
Nobody likes a surprise at the end of a ride. That is why the price is produced before the booking, from the company’s price list, and the passenger sees it in the app. The same calculation is available to other systems, so they show the same amount.
POST/api/v1/quote
Price estimate. Scope pricing. If you send coordinates, distance and duration come from routing; if you send distanceKm and durationMinutes, those are used.
| Field | Type | Required | Description |
|---|---|---|---|
serviceTypeId | uuid | ✓ | The service type the price is computed for |
fromZoneId / toZoneId | uuid | — | For fixed inter-zone prices (e.g. airport) |
pickupLatitude / pickupLongitude | number | — | Pickup coordinates |
dropoffLatitude / dropoffLongitude | number | — | Destination coordinates |
distanceKm / durationMinutes | number | — | If the route is unknown, send them yourself |
averageSpeedKmh | number | — | Average speed used to estimate time |
at | ISO 8601 | — | The moment the price list applies to (night rate, holiday) |
curl -s -X POST https://driveos.eu/api/v1/quote \
-H "X-API-Key: $DEMO_TAXI_KEY" \
-H 'Content-Type: application/json' \
-d '{
"serviceTypeId": "8f1c2a6e-6d4b-4f2a-9d31-2a7c1b6e5f01",
"pickupLatitude": 45.8127, "pickupLongitude": 15.9700,
"dropoffLatitude": 45.7429, "dropoffLongitude": 16.0688,
"at": "2026-11-18T04:30:00Z"
}'
{
"quote": {
"serviceTypeId": "8f1c2a6e-6d4b-4f2a-9d31-2a7c1b6e5f01",
"currencyCode": "EUR",
"maximumPrice": 24.80,
"distanceKm": 17.4,
"durationMinutes": 28,
"breakdown": [
{ "code": "BASE", "label": "Start", "amount": 2.30 },
{ "code": "DISTANCE", "label": "Kilometri (17,4 km)", "amount": 19.14 },
{ "code": "TIME", "label": "Vrijeme (28 min)", "amount": 3.36 }
],
"zonePrice": null,
"multiplier": 1.0
}
}
What goes into the priceBase, distance and time from the service type’s price list; the price-list multiplier (e.g. night work); a fixed inter-zone price when both zones are known; waiting rules and minimum fares. All of that is a company setting, not an integration setting.
Estimate and final price
| Moment | What you get |
|---|---|
| Before booking | maximumPrice — the maximum price and its breakdown |
| On booking | estimatedPrice in the ride detail (the same value) |
| After completion | finalPrice — the real price by the travelled route and waiting, never above the maximum |

