Create Order

POST

https://api.sharkship.in/v1/b2c/order/create

Creates a new B2C order.

Endpoint: POST /v1/b2c/order/create

Headers:

Authorization: Bearer <token>

Request body:

customer — recipient details and delivery address

order — product details, payment mode (COD, PREPAID, PARTIAL_COD), optional service_type (PAN_INDIA, SDD, NDD, SDD_NDD), and optional lineItems array

pickup_details — pickup hub address_id

shipment_details — package weight, optional volumetric dimensions, and carrier info (carrierId, courier_type, base_weight)

Response (201): Returns order_id and awb_no.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.sharkship.in/v1/b2c/order/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer": {
        "name": "John Doe",
        "mobile_no": "9876543210",
        "email": "john.doe@example.com",
        "address": {
            "address_lane1": "123 Main Street",
            "address_lane2": "",
            "Pin": "110001",
            "landmark": "",
            "city": "New Delhi",
            "state": "Delhi",
            "pin": 110001
        }
    },
    "order": {
        "product_name": "Shirt",
        "product_price": 1000,
        "cod_amount": 1000,
        "product_quantity": 1,
        "tax_rate": "",
        "product_sku_no": "SKU-DUMMY-001",
        "client_orderId": "ORD-DUMMY-001",
        "product_category": "Apparels and Accessories",
        "payment_mode": "COD",
        "service_type": "PAN_INDIA",
        "lineItems": [
            {
                "product_name": "Shirt",
                "product_price": 1000,
                "product_quantity": 1,
                "product_category": "Apparels and Accessories",
                "product_sku_no": "SKU-DUMMY-001",
                "tax_rate": null
            }
        ]
    },
    "pickup_details": {
        "address_id": "1"
    },
    "shipment_details": {
        "weight": 0.5,
        "volumetric_weight": {
            "length": 10,
            "width": 10,
            "height": 10
        },
        "carrier": {
            "carrierId": 101,
            "courier_type": "SURFACE",
            "base_weight": 0.25
        }
    }
}'

Response Example

{
    "order_id": 7226574,
    "awb_no": "77047855511"
}

Modified at 2026-06-16 10:11:15

Create Orders

Cancel Orders