Launching soon. Check your price now and join the list to be first when bookings open. Check your price

Sendway

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

POST/v1/quote-requests

Requires 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.

bash
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"
  }'
json
{
  "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

POST/v1/quote-requests/:id/accept

Requires 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.

Accepting after 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

GET/v1/quote-requests/:id
GET/v1/quote-requests?status=QUOTED
POST/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.