Calculate delivery price quotes before booking.
Pricing
Pricing
Get a price quote before creating a delivery. Use this to show customers the delivery fee at checkout.
Calculate Price
POST /api/v1/calculate-price
Content-Type: application/jsonOn-demand quote
{
"fromLatitude": 29.3764,
"fromLongitude": 47.9785,
"toLatitude": 29.3117,
"toLongitude": 48.0034,
"deliveryArea": "Salmiya, Block 3",
"deliveryPaciArea": "Salmiya"
}Response:
{
"quote": {
"distance": 4.2,
"distanceUnit": "km",
"price": "2.500",
"currency": "KWD",
"estimatedDuration": 12,
"tierLabel": "0–5 km",
"specialZone": null
}
}Scheduled quote
Set isScheduled: true to get the flat scheduled rate instead of distance-based pricing.
{
"fromLatitude": 29.3764,
"fromLongitude": 47.9785,
"toLatitude": 29.3117,
"toLongitude": 48.0034,
"isScheduled": true
}Response:
{
"quote": {
"price": "2.000",
"currency": "KWD",
"pricingMode": "scheduled",
"tierLabel": "Scheduled delivery (flat rate)"
}
}Request fields
| Field | Aliases | Required | Description |
|---|---|---|---|
fromLatitude | pickupLatitude | Yes | Pickup latitude |
fromLongitude | pickupLongitude | Yes | Pickup longitude |
toLatitude | deliveryLatitude | Yes | Drop-off latitude |
toLongitude | deliveryLongitude | Yes | Drop-off longitude |
deliveryArea | — | No | Improves zone-based pricing accuracy |
deliveryPaciArea | — | No | PACI area name |
isScheduled | — | No | Set true for scheduled flat rate |
Special zones
Some areas have fixed prices regardless of distance.
| Zone | Areas | Price |
|---|---|---|
| Al Wafra / Al Khiran / Al Mutlaa | Wafra Farms, Wafra Residential, Sabah Al-Ahmad 1–6, Al Mutlaa 1–12 | 5.000 KWD |
| Al Jahra / Ali Sabah Al Salam | Jahra, Sabah Al Salam | 3.000 KWD |
📝 Zone detection
Pass deliveryArea or deliveryPaciArea to help the API match special zones accurately when the delivery address is in a boundary area.