Flit
  1. Orders
Flit
  • Flit Client API
    • Pricing
      • Check Serviceability and Calculate Price
    • Orders
      • Create New Order
        POST
      • Cancel Order
        POST
      • Get Order Details
        GET
    • Schemas
      • Schemas
        • Order
        • Error
      • Response
        • UnauthorizedError
        • InternalServerError
  1. Orders

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 *****************
or
Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Order created successfully
Body

🟠400Bad Request
🟠401Unauthorized
🔴500Internal Server Error
Request 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 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
Previous
Check Serviceability and Calculate Price
Next
Cancel Order
Built with