Create New Order

POST

/create-order

Create a new delivery order.

Important Notes:

For dashboard orders (platform: "dashboard"), sufficient wallet balance is required

Wallet balance will be deducted when rider picks up the order

Order creation will fail if wallet balance is insufficient (≤ 0)

Request

Authorization

Basic Auth

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/jsonRequired

Examples

Responses

🟢200OK

application/json

Order created successfully

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/create-order' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pickupLocation": {
        "latitude": 12.9352,
        "longitude": 77.6245,
        "address": "123 Koramangala, Bangalore, Karnataka 560095",
        "name": "John Doe",
        "phone": "+919876543210",
        "pin": "1234"
    },
    "dropLocation": {
        "latitude": 12.9716,
        "longitude": 77.5946,
        "address": "456 Indiranagar, Bangalore, Karnataka 560038",
        "name": "Jane Smith",
        "phone": "+919876543211",
        "pin": "5678"
    },
    "item_description": "food items",
    "weight": 2.5,
    "payment_method": "cash",
    "payment_collect_point": "pickup",
    "order_amount": 500,
    "platform": "dashboard"
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Order created successfully",
    "data": {
        "order": {
            "_id": "507f1f77bcf86cd799439011",
            "orderId": "FLT-2024-00001",
            "status": "pending",
            "pickupLocation": {
                "address": "123 Koramangala, Bangalore",
                "name": "John Doe",
                "phone": "+919876543210",
                "latitude": 12.9352,
                "longitude": 77.6245
            },
            "dropLocation": {
                "address": "456 Indiranagar, Bangalore",
                "name": "Jane Smith",
                "phone": "+919876543211",
                "latitude": 12.9716,
                "longitude": 77.5946
            },
            "itemDescription": "food items",
            "grandTotal": 85,
            "paymentMethod": "cash",
            "createdAt": "2024-01-15T10:30:00.000Z",
            "deliveryPhoto": "https://s3.amazonaws.com/flit-bucket/delivery-photos/507f1f77bcf86cd799439011.jpg"
        }
    }
}

Modified at 2025-10-07 17:45:45

Check Serviceability and Calculate Price

Cancel Order