Flasho
Support

Book flat-rate scheduled deliveries up to 14 days in advance.

Scheduled Delivery

Scheduled Delivery

Scheduled deliveries use a flat surcharge rate rather than distance-based pricing. They must be enabled by Flasho for your account.

Check availability

GET /api/v1/scheduled-delivery
{
  "scheduledDelivery": {
    "globalEnabled": true,
    "merchantEnabled": true,
    "enabled": true,
    "available": true,
    "surchargeKwd": "2.000",
    "payAsYouGoEnabled": false
  }
}

Only proceed with scheduled bookings when available is true.

Get a price quote

POST /api/v1/calculate-price
Content-Type: application/json
 
{
  "fromLatitude": 29.3764,
  "fromLongitude": 47.9785,
  "toLatitude": 29.3117,
  "toLongitude": 48.0034,
  "isScheduled": true
}
{
  "quote": {
    "price": "2.000",
    "currency": "KWD",
    "pricingMode": "scheduled",
    "tierLabel": "Scheduled delivery (flat rate)"
  }
}

Book a scheduled delivery

POST /api/v1/deliveries
Content-Type: application/json
{
  "customerName": "Ahmed Ali",
  "customerNumber": "99887766",
  "pickupLatitude": 29.3764,
  "pickupLongitude": 47.9785,
  "deliveryLatitude": 29.3117,
  "deliveryLongitude": 48.0034,
  "deliveryAddress": ["Kuwait", "Salmiya", "Block 3", "Street 1", "House 12"],
  "isScheduled": true,
  "scheduledDeliveryAt": "2026-07-01T10:00:00.000Z",
  "specialNotes": "Ring doorbell",
  "vehicleType": "bike",
  "collectCash": false,
  "totalAmount": "0.000"
}

Scheduling rules

⚠️ Time constraints

  • Minimum: 30 minutes from current time
  • Maximum: 14 days ahead
  • scheduledDeliveryAt must be an ISO 8601 UTC datetime string

Pay As You Go billing

If payAsYouGoEnabled is true on your account, scheduled deliveries may not immediately debit your wallet. Instead they are invoiced at the end of the billing period. Settlement instructions are available in the /api/v1/bootstrap response under scheduledDelivery.paygSettlementInstructions.

← PreviousDeliveriesNext →JavaScript SDK