MOVER BUSINESS API
  1. Orders
MOVER BUSINESS API
  • Orders
    • Estimate / Coverage
      POST
    • Book Vehicle
      POST
    • Invoice
      GET
    • Status
      GET
    • Cancel
      POST
    • Partner Location
      GET
    • Pool
      POST
  • Utility
    • Segregate Delivery Locations
      POST
  • Webhooks
  1. Orders

Book Vehicle

POST
https://api.boxnmove.com/business/book-vehicle
Book a vehicle for delivering goods from a specified pickup location to a drop-off location. It requires detailed information about the pickup and drop-off points, vehicle and goods types, and additional delivery preferences such as route optimization and insurance for the goods.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.boxnmove.com/business/book-vehicle' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "type": "parcel",
    "ship_mode": "on_demand",
    "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
}'
Response Response Example
200 - Success
{
  "orderid": "XYZZZZZZZZ",
  "statusid": 1,
  "message": "Order created.",
  "serviceid": "77b4ed7a-7ee3-11ef-bc55-7c1e523ba329"
}

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
pickup_loc
object 
required
Same as pickup payload of Estimate / Coverage endpoint
lat
integer 
required
lon
integer 
required
address
string 
required
delivery_note
string 
required
contact_mobile
string 
required
contact_name
string 
required
udf1
string 
required
delivery_code
string 
optional
Specifiy a delivery code / otp the contact person must provide to process delivery at the location point
client_ref_id
string 
required
Sepcify your order reference/id to display to our partners
drop_loc
object 
required
Same as drop payload of Estimate / Coverage endpoint
lat
integer 
required
lon
integer 
required
address
string 
required
delivery_note
string 
required
contact_mobile
string 
required
contact_name
string 
required
udf1
string 
required
delivery_code
string 
optional
Specifiy a delivery code / otp the contact person must provide to process delivery at the location point.
client_ref_id
string 
required
Specify an OrderId,Ref. Id to display to our delivery partners.
vehicle_id
integer 
required
Chosen vehicle's Vehicle Id returned in Estimate / Coverage endpoint response.
goods_type_id
integer 
required
1 Timber / Plywood / Laminat
2 Electrical / Electronics / Home Appliances
3 Building / Construction
4 Catering / Restaurant / Event Management
5 Machines / Equipments / Spare Parts / Metals
6 Textile / Garments / Fashion Accessories
7 Furniture / Home Furnishing
8 House Shifting
9 Ceramics / Sanitary / Hardware
10 Paper / Packaging / Printed Material
11 Chemicals / Paints
12 Logistics service provider / Packers and Movers
13 Perishable food items
14 Pharmacy / Medical / Healthcare / Fitness Equipment
15 FMCG / Food Products
16 Plastic / Rubber
17 Books / Stationery / Toys / Gifts
18 Others
stops
array[string]
required
Same as "waypoints" parameter in estimate/coverage endpoint
insure_goods
boolean 
required
true or false . Used to generate insurance policy for the package to cover the accidental damage in transit
optimise_route
boolean 
required
Same as defined in estimate/coverage endpoint
no_of_packages
integer 
required
Total number of packages.
goods_worth
integer 
required
The value of package(s) in Indian Rupees (INR)
type
string 
required
Specifies the type of delivery, accepting only 'food' or 'parcel'
ship_mode
string 
required
Specifies the shipping mode of delivery, accepting only 'on_demand' , 'sdd' (Same Day Delivery) , 'ndd' (Next Day Delivery)
delivery_charge_pay_mode
string 
required
Specifies the payment mode of delivery fee, accepting only 'online_on_delivery' ,'prepaid' ,'cod' and 'codparcel'
delivery_charge
object 
optional
Specifies the cash amount (in INR) to be collected upon delivery completion when delivery_charge_pay_mode is set to 'cod' (cash on delivery).
amount
integer 
required
base amount
other
integer 
required
other charges if any else 0
gst
integer 
required
GST if applicable else 0
parcel_amount
number 
required
parcel_amount to be collected in cash
total
integer 
required
grand total /final delivery charge to be collected > 0
Examples

Responses

🟢200Success
application/json
Body
orderid
string 
required
statusid
integer 
required
message
string 
required
serviceid
string 
required
Service Id of the order when mover decides to process it in pool for efficient deliveries.
🟠400Bad Request
Modified at 2025-04-25 10:05:34
Previous
Estimate / Coverage
Next
Invoice
Built with