Before dispatching an order, get a live delivery quote from Uber Direct. The estimate endpoint returns the delivery fee in KES and an ETA so your customers know exactly what to expect before they commit.
This endpoint requires the X-Organization-Id header and the logistics:delivery:read permission.
Request a delivery estimate
Send a POST request to /v1/logistics/estimate with the pickup and dropoff locations. Include both a human-readable address and GPS coordinates for accurate routing.
curl -X POST https://api.nyotaimara.com/v1/logistics/estimate \
-H "Authorization: Bearer <your_token>" \
-H "X-Organization-Id: org_01j9kxp8a3bvc0nqrtzwmde4fy" \
-H "Content-Type: application/json" \
-d '{
"pickup": {
"address": "14 Mombasa Road, Industrial Area, Nairobi",
"lat": -1.3031,
"lng": 36.8479
},
"dropoff": {
"address": "45 Ngong Road, Upper Hill, Nairobi",
"lat": -1.2966,
"lng": 36.8040
}
}'
{
"success": true,
"data": {
"fee": 35000,
"quoteId": "quote_uber_8f3a9c1e4b2d",
"eta": "2025-11-04T11:45:00.000Z"
}
}
The fee is returned in the lowest currency denomination from Uber Direct. For KES, this means the value is in cents — divide by 100 to get the amount in shillings. In the example above, 35000 = 350 KES.
Use the quote ID
Save the quoteId from the estimate response. When you are ready to dispatch, pass this ID when creating the actual delivery to lock in the quoted price and ETA.
Quote IDs have a short validity window. Request an estimate close to the time of dispatch rather than hours in advance.
Request body reference
| Field | Type | Required | Description |
|---|
pickup.address | string | Yes | Human-readable pickup address |
pickup.lat | number | Yes | Pickup latitude (decimal degrees) |
pickup.lng | number | Yes | Pickup longitude (decimal degrees) |
dropoff.address | string | Yes | Human-readable dropoff address |
dropoff.lat | number | Yes | Dropoff latitude (decimal degrees) |
dropoff.lng | number | Yes | Dropoff longitude (decimal degrees) |
Response field reference
| Field | Type | Description |
|---|
fee | number | Delivery fee in lowest denomination (divide by 100 for KES) |
quoteId | string | Uber Direct quote ID — use when booking the delivery |
eta | string | Estimated dropoff time (ISO 8601 UTC) |
