SoPilot Fleet API
REST API v1 · JSON · webhooks
Sign in

Authentication

Every request carries a tenant-scoped key in the X-API-Key header. Keys are created in Settings → API keys. All timestamps are Asia/Riyadh. Base URL: https://fleet.intilaq.host/api/v1

curl -H "X-API-Key: sk_wasil_b4d223662d1853209149" https://fleet.intilaq.host/api/v1/bookings?upcoming=1

Endpoints

MethodPathDescription
GET/quotePrice a trip: from, to, vehicle_type, trip_type, date, promo_code. Same rules engine as the UI and the AI agent.
GET/locationsPickup / drop-off points the operator prices.
GET/bookingsList bookings. Filters: status, date, customer_phone, upcoming=1, limit.
POST/bookingsCreate a booking (auto-priced, duplicate-checked, WhatsApp confirmation sent, optional auto_dispatch).
GET/bookings/{code}Booking details incl. driver & voucher URL.
PATCH/bookings/{code}Reschedule / edit: pickup_at, passengers, flight_no, pickup_note, notes.
DELETE/bookings/{code}Cancel (customer notified).
GET/vehicles · /driversFleet and driver roster with live status.

Create a booking

curl -X POST https://fleet.intilaq.host/api/v1/bookings \ -H "X-API-Key: sk_wasil_b4d223662d1853209149" -H "Content-Type: application/json" \ -d '{ "customer_name": "Abdul Rahman Khan", "customer_phone": "+92 300 1234567", "from": "Jeddah Airport (KAIA)", "to": "Makkah", "pickup_at": "2026-09-14T04:30:00", "passengers": 5, "vehicle_type": "suv", "flight_no": "PK 741", "source": "whatsapp_ai", "auto_dispatch": true }'
Response 201 returns the booking (code, total, driver if dispatched, voucher_url) and the full quote breakdown. Errors: 422 validation (with the field list), 409 duplicate (send force:true), 401 bad key.

Webhooks

Register an HTTPS endpoint per tenant; events are signed with HMAC-SHA256 (X-Signature) and retried with backoff.

{ "event": "booking.assigned", "tenant": "wasil", "data": { "code": "SF-7K2M9Q", "status": "assigned", "pickup_at": "…", "driver": { "name": "…", "plate": "…" } }, "sent_at": "2026-09-12T00:01:49+03:00" }
Events: booking.created · booking.updated · booking.assigned · booking.en_route · booking.completed · booking.cancelled · payment.received · conversation.handoff

Try it now

Live call against this demo tenant.
// response appears here

Integrations

💬
WhatsApp Cloud API / Messenger / Instagram
official Meta channels via SoPilot Pro (Tech Provider)
🧠
n8n workflow
orchestrates the AI agent, ticket OCR, voice transcription
💳
Payments
Mada, STC Pay, Apple Pay, cards, InstaPay (Egypt), Stripe for SaaS billing
🗺️
Maps
Google Maps navigation & ETA
🕋
Nusuk
permit & itinerary tie-ins (roadmap)
📊
Exports
CSV, Google Sheets, accounting (Zoho / QuickBooks) via webhooks