Create a delivery request for an order placed at a store/dark-store.
Attribute Value Method / Path POST /api/v3/clients/orders/Staging URL https://dale.staging.shadowfax.in/api/v3/clients/orders/Auth Authorization: Bearer <ACCESS_TOKEN>
The eta_details object communicates pickup and delivery timing expectations for quick-commerce orders. All fields inside eta_details are optional.
Request Payload
{ "order_details" : { "client_order_id" : "ORD-2026-000123" , "customer_order_id" : "0123456" , "actual_weight" : 100 , "volumetric_weight" : 100 , "product_value" : 5555 , "payment_mode" : "Prepaid" , "cod_amount" : "0" , "promised_delivery_date" : "2026-07-09T00:00:00.000Z" , "total_amount" : 5555 , "eway_bill" : "7452128" , "gstin_number" : "74185263" , "order_service" : "regular" , "eta_details" : { "pickup_ready_time" : 1694568000 , "assignment_time" : 1694568000 , "transit_time" : 1800000 , "customer_promised_delivery_time" : 1694569500 , "serviceability_id" : "ABCD1234" } }, "customer_details" : { "name" : "Jane Doe" , "contact" : "9999999999" , "address_line_1" : "Flat 38, Example Apartments, Sector 9" , "address_line_2" : "Near Community Park" , "city" : "New Delhi" , "state" : "Delhi" , "pincode" : 110001 , "alternate_contact" : "9999999999" , "latitude" : "11.0000" , "longitude" : "77.0000" }, "pickup_details" : { "name" : "Example Dark Store" , "contact" : "9999999999" , "address_line_1" : "8th Main, 5th Cross" , "address_line_2" : "Business Park" , "city" : "Bengaluru" , "state" : "Karnataka" , "pincode" : 560007 , "latitude" : "12.0000" , "longitude" : "78.0000" , "unique_code" : "STORE_0001" }, "return_details" : { "name" : "Returns Desk" , "contact" : "9999999999" , "address_line_1" : "Sector-24, House No-76" , "address_line_2" : "Near Temple" , "city" : "Ludhiana" , "state" : "Punjab" , "pincode" : 110009 , "email" : "returns@example.com" , "latitude" : "12.0000" , "longitude" : "78.0000" , "unique_code" : "WAREHOUSE_0001" }, "product_details" : [ { "hsn_code" : "HJUY890" , "invoice_no" : "INV-678" , "sku_name" : "Product Name" , "sku_id" : "SKU-789" , "category" : "grocery" , "price" : 4500 , "seller_details" : { "seller_name" : "Example Seller Pvt Ltd" , "seller_address" : "Seller Address, City, District" , "seller_state" : "Karnataka" , "gstin_number" : "HDS798HG" }, "taxes" : { "cgst" : 3 , "sgst" : 4 , "igst" : 5 , "total_tax" : 5.6 }, "additional_details" : { "requires_extra_care" : "False" , "type_extra_care" : "Fragile" , "quantity" : 2 } } ] }
eta_details Field Reference
Field Type Required Description pickup_ready_timeepoch (sec) No Time at which the order will be ready for rider pickup at the store assignment_timeepoch (sec) No Time at which the order is expected to be assigned to a rider transit_timemilliseconds No Expected transit duration from store to customer customer_promised_delivery_timeepoch (sec) No SLA committed to the end customer serviceability_idstring No Serviceability check reference id issued for this order/route
pickup_details Field Reference
Field Type Required Description unique_codestring Conditional Client-defined identifier for the dark store / pickup location, mapped to a Shadowfax hub. Required for store-based accounts — confirm with your integration POC whether yours needs it.
Response
{ "message" : "Success" , "errors" : null , "data" : { "id" : 3179745 , "client_name" : "<Client Name>" , "client_order_id" : "ORD-2026-000123" , "awb_number" : "SF1508925664XXX" , "product_value" : 5555.0 , "cod_amount" : 0 , "payment_mode" : "prepaid" , "order_date" : "2026-07-09" , "promised_delivery_date" : "2026-07-09T18:30:00Z" , "status_display" : "New" , "status" : "new" , "pickup_details" : { }, "delivery_details" : { }, "product_details" : [ ], "sort_code" : "A4" } }
Save the awb_number — it identifies the shipment in update and cancel calls.
Common Errors
HTTP Status Scenario 400 Invalid store unique_code, or missing where your account requires one 401 Invalid or expired bearer token 409 Duplicate client_order_id for the same client
See Errors for the error envelope format.
API Reference
Last modified on August 2, 2026
