Domestic Order (Forward)
POST/auth/api/v1/orders/order-create
What Is a Forward Order?
A forward order is a shipment picked up from the client's warehouse and delivered to the end customer's doorstep. This API allows you to create forward orders by submitting shipment, pickup, and drop-off details.
This endpoint supports both domestic and international shipments — determined by values like customer_country_code in your payload.
This guide focuses on booking a domestic forward order.
⚠️ Important: Use the location name registered with Logistiq in the
pickup_info_nameandreturn_info_namefields.
Optional but Recommended Fields
These fields are optional at the schema level but strongly recommended for better delivery success and end-customer experience:
| Field | Purpose |
|---|---|
customer_email | Enables shipment tracking and delivery update emails. |
customer_phone | Enables SMS notifications and courier coordination. |
delivery_instructions | Helps ensure successful first-attempt delivery. |
💡 Tip: Including these fields helps you follow the “happy path” for full feature support and optimal performance.
Responses
- 200
- 400
- 401
Order created successfully or forwarded to workflow handler
Validation error or order processing failure
Authentication credentials were not provided