Domestic Order (Return)
POST/auth/api/v1/orders/order-create
What Is a Return Order?
A return order involves picking up a shipment from the end customer and delivering it back to the client's warehouse or another designated location.
This API allows you to initiate a domestic return by providing the necessary pickup and return details.
The Return API supports domestic orders only. International return shipments are not supported through this endpoint.
This guide covers how to create a domestic return order via the Return API.
⚠️ Important: Provide the location name registered with Logistiq in the
return_info_namefield.
Optional but Recommended Fields
The following fields are optional in the schema but strongly recommended to ensure smoother pickups and better customer experience:
| Field | Purpose |
|---|---|
customer_email | Enables shipment tracking and return updates to the customer. |
customer_phone | Facilitates SMS notifications and pickup coordination. |
delivery_instructions | Improves first-attempt pickup success rate. |
💡 Tip: Including these fields can significantly enhance operational reliability and customer satisfaction.
Responses
- 200
- 400
- 401
Order created successfully or forwarded to workflow handler
Validation error or order processing failure
Authentication credentials were not provided