Saaml Operations delivers across Saudi Arabia. Book your shipment in a chat.Send a shipment
    Back to Developers
    API Reference · v1.0

    Quick Commerce API — Partner Integration Guide

    Instant ≤60-minute deliveries: availability check, create with service_level quick_commerce, live tracking, and QC dispatch configuration.

    Overview

    Section 1 of 13

    Quick Commerce (QC) shipments are dispatched instantly: on creation, SAAML broadcasts the job to nearby online captains (starting radius ~10 km around the pickup warehouse, expanding to ~15 km) and the first captain to accept is assigned. There are no missions or batching — the SLA clock starts at creation.

    1. 1

      Check availability

      POST /api/shipment/availability-check — are captains online near the warehouse?

    2. 2

      Create with service_level

      POST /api/shipment/lastmile/new with service_level: quick_commerce (and optional sla_minutes).

    3. 3

      Share tracking

      Give the customer short_tracking_url; print sticker_url for the label.

    4. 4

      Receive updates

      Poll GET /api/tracking, or use status webhooks from the Last Mile guide.

    Same create endpoint as Last Mile— QC is selected via service_level. Do not send dispatch_mode; it is set server-side.