Create Order (On Demand)

Developing

POST

https://api.boxnmove.com/business/create-order

Place an On Demand delivery order by defining pickup and drop points, delivery requirements, and payment preferences, supports multi-pickup and multi drop deliveries.

a location point in the order is considered a node

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.boxnmove.com/business/create-order' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "type": "parcel",
    "ship_mode": "on_demand",
    "route_info": {
        "distance": 12450,
        "duration": 1580
    },
    "pickup_loc": {
        "lat": 28.414093434043952,
        "lon": 77.02948514420679,
        "address": "Gurgaon",
        "delivery_note": "",
        "contact_mobile": "9999999999",
        "contact_name": "Jhon Doe",
        "udf1": "",
        "delivery_code": "3456"
    },
    "drop_loc": {
        "lat": 28.394813204711046,
        "lon": 77.0308444087546,
        "address": "Gurgaon",
        "delivery_note": "",
        "contact_mobile": "9999999999",
        "contact_name": "Jhon Doe",
        "udf1": "",
        "delivery_code": "3456"
    },
    "vehicle_id": 5,
    "goods_type_id": 1,
    "stops": [
        {
            "lat": 28.415650408416976,
            "lon": 77.03899832427274,
            "address": "Stop 1 Gurgaon",
            "delivery_note": "",
            "contact_mobile": "9999999999",
            "contact_name": "Jhon Doe",
            "udf1": "",
            "delivery_code": "3456"
        },
        {
            "lat": 28.403344874110218,
            "lon": 77.04225989014573,
            "address": "Stop 2 Gurgaon",
            "delivery_note": "",
            "contact_mobile": "9999999999",
            "contact_name": "Jhon Doe",
            "udf1": "",
            "delivery_code": "3456"
        }
    ],
    "insure_goods": false,
    "optimise_route": false,
    "no_of_packages": 1,
    "goods_worth": 0,
    "estimate_id":"16dcf6ba-5c7f-4dbc-9068-8fe3c55a9a54"
}'

Response Example

200 - Success

{
    "orderid": "XYZZZZZZZZ",
    "statusid": 1,
    "message": "Order created."
}

Modified at 2026-01-23 13:18:23

Estimate / Coverage

Status