1. Shipping Rates
  • 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. Shipping Rates

Get Shipping Rate (Retail)

GET
https://api.sharkship.in/v1/b2c/order/shipping-rate-retail
This endpoint retrieves retail shipping rates for a shipment based on source and destination pincodes, payment type, weight, and product value. Dimensions (length, width, height) are passed as request headers.

Query Parameters#

source (number): Source pincode
destination (number): Destination pincode
payment_type (string): COD or PREPAID
weight (number): Package weight in kg
productValue (number): Declared product value

Headers#

length (number): Package length in cm
width (number): Package width in cm
height (number): Package height in cm
service_type (string): PAN_INDIA, SDD, or NDD

Response#

Returns a rates array containing available carrier rates with pricing breakdown, zone info, COD charges, and weight calculation details.

Request

Query Params

Header Params

Responses

🟢200
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.sharkship.in/v1/b2c/order/shipping-rate-retail?source=201307&destination=452001&payment_type=COD&weight=0.5&productValue=1000' \
--header 'Authorization: Bearer <token>' \
--header 'length: 10' \
--header 'width: 10' \
--header 'height: 10' \
--header 'service_type: PAN_INDIA'
Response Response Example
{
  "rates": [
    {
      "id": "8c8a91ab-3fae-4c40-b03b-2aa03ff6fa85",
      "carrier": "Amazon_ATS",
      "carrierId": 1,
      "courier_type": "SURFACE",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 89,
      "cod": 34,
      "base_weight_rate": 41,
      "additional_weight_rate": 24,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 41",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "f10661f3-ebd9-4e0e-8a23-e705f0c082b0",
      "carrier": "Amazon_ATS",
      "carrierId": 1,
      "courier_type": "SURFACE",
      "base_weight": 2,
      "service_type": "PAN_INDIA",
      "additional_weight": 1,
      "rate": 174,
      "cod": 34,
      "base_weight_rate": 113,
      "additional_weight_rate": 49,
      "weight_calculation": "Weight is within base weight (0.5kg <= 2kg). Base rate applied: 113",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "3fdcfd58-1b59-4821-93af-fdcb125579c1",
      "carrier": "BlueDart",
      "carrierId": 8,
      "courier_type": "EXPRESS",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 126,
      "cod": 36,
      "base_weight_rate": 70,
      "additional_weight_rate": 70,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 70",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "a56dc460-1663-437e-9fc0-af6750154b61",
      "carrier": "BlueDart",
      "carrierId": 8,
      "courier_type": "SURFACE",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 104,
      "cod": 36,
      "base_weight_rate": 52,
      "additional_weight_rate": 52,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 52",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "c47d091f-cd0c-49ca-bc7b-539b42ea483e",
      "carrier": "Delhivery",
      "carrierId": 7,
      "courier_type": "EXPRESS",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 114,
      "cod": 34,
      "base_weight_rate": 62,
      "additional_weight_rate": 60,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 62",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "71c2e8f4-eef2-44c3-8ba9-c66bc09b4dee",
      "carrier": "Delhivery",
      "carrierId": 7,
      "courier_type": "SURFACE",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 95,
      "cod": 34,
      "base_weight_rate": 46,
      "additional_weight_rate": 42,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 46",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "4d9dceb9-872e-45eb-b475-a5ede463b975",
      "carrier": "Ekart",
      "carrierId": 6,
      "courier_type": "EXPRESS",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 117,
      "cod": 35,
      "base_weight_rate": 64,
      "additional_weight_rate": 47,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 64",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "70c24b68-ae7f-47cb-a8de-b7d7864f951c",
      "carrier": "Ekart",
      "carrierId": 6,
      "courier_type": "SURFACE",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 91,
      "cod": 35,
      "base_weight_rate": 42,
      "additional_weight_rate": 33,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 42",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "1b585c27-3e4a-4da2-9bc1-70ca38fbff22",
      "carrier": "Shadowfax",
      "carrierId": 2,
      "courier_type": "SURFACE",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 88,
      "cod": 34,
      "base_weight_rate": 40,
      "additional_weight_rate": 36,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 40",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "86a75566-d1c3-4c9a-bede-ec3c0012b48e",
      "carrier": "Shree_Maruti",
      "carrierId": 4,
      "courier_type": "EXPRESS",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 140,
      "cod": 35,
      "base_weight_rate": 83,
      "additional_weight_rate": 83,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 83",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "d278ea39-305e-42ce-997f-d1eb586e66a6",
      "carrier": "Shree_Maruti",
      "carrierId": 4,
      "courier_type": "SURFACE",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 104,
      "cod": 35,
      "base_weight_rate": 53,
      "additional_weight_rate": 53,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 53",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    },
    {
      "id": "62b17174-fa76-4f42-b092-5450d8598bb7",
      "carrier": "XpressBees",
      "carrierId": 3,
      "courier_type": "SURFACE",
      "base_weight": 0.5,
      "service_type": "PAN_INDIA",
      "additional_weight": 0.5,
      "rate": 93,
      "cod": 34,
      "base_weight_rate": 44,
      "additional_weight_rate": 36,
      "weight_calculation": "Weight is within base weight (0.5kg <= 0.5kg). Base rate applied: 44",
      "source": 201307,
      "destination": 452001,
      "zone": "zone4"
    }
  ]
}
Modified at 2026-06-16 10:11:15
Previous
Shipping Rates
Built with