1. Create Orders
  • Authentication API
    • Generate API Token
      POST
  • Create Orders
    • Create Order
      POST
  • Cancel Orders
    • Cancel Order
      PUT
  • Shipping Label
    • Download Shipping Label
      POST
    • Shipping Label Configurations
      GET
    • Update Shipping Label Configurations
      PUT
  • Shipment Tracking
    • Tracking
      GET
  • Couriers
    • Courier Partners
      GET
  • NDR
    • Reattempt NDR
      PUT
  • Pickup Addresses
    • Pickup Hub ids
      GET
    • Create Pickup Hub Id
      POST
    • Pickup Hub Id
      DELETE
  • Shipping Rates
    • Get Shipping Rate (Retail)
      GET
  1. Create Orders

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 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 Response Example
{
    "order_id": 7226574,
    "awb_no": "77047855511"
}
Modified at 2026-06-16 10:11:15
Previous
Create Orders
Next
Cancel Orders
Built with