Integrate your website or mobile app with Flasho deliveries.
Flasho Merchant API
Flasho Merchant API
Welcome to the Flasho Merchant API documentation. Use this API to integrate on-demand and scheduled deliveries directly into your website or mobile application.
Base URL: https://vendors.tryflasho.com
What you can do
Book deliveries
Create on-demand and scheduled deliveries programmatically.
Get price quotes
Calculate delivery costs before booking.
Track orders
Poll delivery status and driver information.
Manage branches
Configure your pickup locations.
Platform apps
Skip the API if your store already runs on Shopify, WooCommerce, Odoo, OpenCart, nopCommerce, or PrestaShop.
Shopify
Pre-built app. New orders create Flasho deliveries automatically.
WooCommerce
Connect a WooCommerce store for automatic delivery booking and tracking.
Odoo
Book and track Flasho deliveries from Odoo sales orders.
OpenCart
Book and track Flasho deliveries from OpenCart orders.
nopCommerce
Book and track Flasho deliveries from nopCommerce orders.
PrestaShop
Book and track Flasho deliveries from PrestaShop orders.
Quick start
Get your API key
Log into the Flasho dashboard and generate an API key under Website API. Keys start with flsh_.
Make your first request
Call the bootstrap endpoint to confirm your credentials and load your account in one shot.
curl https://vendors.tryflasho.com/api/v1/bootstrap \
-H "Authorization: Bearer flsh_YOUR_KEY"Book a delivery
Send pickup and drop-off coordinates with customer details to create a delivery.
curl -X POST https://vendors.tryflasho.com/api/v1/deliveries \
-H "Authorization: Bearer flsh_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"customerName": "Ahmed Ali",
"customerNumber": "99887766",
"pickupLatitude": 29.3764,
"pickupLongitude": 47.9785,
"deliveryLatitude": 29.3117,
"deliveryLongitude": 48.0034
}'Order lifecycle
PENDING → REQUESTED → ACCEPTED → INPROGRESS → PICKEDUP → ENROUTE → DELIVERED
Terminal states: DELIVERED · CANCELLED · REJECTED · FAILED
Currency
All monetary values use KWD (Kuwaiti Dinar) as three-decimal strings, e.g. "2.500".