Quote requests
Some parcels are priced by our team rather than online. Ask for a price, and book it once you accept.
When a quote comes back with "requires_quote": true, or booking returns 409 quote_required, send the same parcel to POST /v1/quote-requests. Our team prices it, usually within working hours on the same day, and you get a quote_request.quoted webhook. Accept it and the parcel is booked into your pickup run at that price.
Ask for a price
/v1/quote-requestsRequires parcels:write. The body is exactly what you would send to POST /v1/parcels, including your reference. Send X-Idempotency-Key as you would for a booking.
curl https://api.shopinn.co.ke/api/sendway/v1/quote-requests \
-H "Authorization: Bearer sw_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "X-Idempotency-Key: quote-order-1042" \
-d '{
"recipient_name": "Amina Otieno",
"recipient_phone": "0712345678",
"sender_phone": "0722000111",
"description": "Three-seater sofa",
"category": "LARGE_ITEM",
"large_item": "sofa_large",
"declared_value": 60000,
"delivery_mode": "STATION",
"dest_town_id": "c3e0e7c5-7925-4c8f-8f01-f273acb9b29d",
"origin_lat": -1.2864,
"origin_lng": 36.8172,
"reference": "order-1042"
}'{
"object": "quote_request",
"livemode": true,
"id": "6d1f0c2a-...",
"reference": "QR-7KQ2MX",
"status": "PENDING",
"category": "LARGE_ITEM",
"summary": "Sofa, 3 seats or more",
"destination": "Nakuru, Nakuru",
"reason": "Sofa, 3 seats or more needs a quote from our team.",
"currency": "KES",
"delivery_fee": null,
"pickup_fee": null,
"cover": null,
"total": null,
"expires_at": null,
"parcel_id": null,
"partner_reference": "order-1042"
}A parcel that already has an online price is refused with quote_not_needed: book it with POST /v1/parcels instead.
When the price is ready
You get quote_request.quoted with the full quote request, now carrying delivery_fee, pickup_fee, cover, total, an optional note from our team and expires_at. The price is held until then, usually 48 hours. If we cannot carry it you get quote_request.declined with a decline_reason. We also text and email the number and address on your SendWay account.
Accept it
/v1/quote-requests/:id/acceptRequires parcels:write. Books the parcel at the quoted total, adds it to your current pickup run and fires parcel.created. The response is a parcel, exactly as from POST /v1/parcels. Like every partner parcel it is paid with the rest of your batch when the rider collects, so there is no M-Pesa prompt.
expires_at fails with quote_request_not_open. Ask for a fresh quote with a new idempotency key.Look one up, list them, cancel one
/v1/quote-requests/:id/v1/quote-requests?status=QUOTED/v1/quote-requests/:id/cancel:id is the id or the QR- reference. Statuses are PENDING, QUOTED, ACCEPTED, DECLINED, EXPIRED and CANCELLED. You can cancel while it is pending or quoted.
Test mode
A test key checks the request and tells you whether it really needs a quote, but nothing reaches our pricing team and nothing is stored. You get back a PENDING quote request with "livemode": false.
Next: webhooks.
