Rate Calculator

Use this API to get the shipping rate for one origin pincode and one destination pincode, before you place an order.

This API is for Prepaid clients. It returns a quote only. No amount is held from your wallet and no order is created.

What you send

Code
curl -X POST "https://dale.staging.shadowfax.in/api/v1/clients/rate_calculator/" \
  -H "Authorization: Token <your_api_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "origin_pincode": 560001,
    "destination_pincode": 110001,
    "weight": 1.5,
    "service": "forward"
  }'

What you get back

Code
{
  "message": "Success",
  "zone": "E",
  "shipping_rate": "69.00",
  "gst": "12.42"
}

shipping_rate is the rate before GST. gst is returned on its own. Add the two to get the total. In the example above the total is 81.42 rupees.

Both amounts come back as strings with two decimal places.

If there is no rate for the pair

The API still returns HTTP 200. The rate fields are null.

Code
{
  "message": "Rate not available for this origin and destination",
  "zone": null,
  "shipping_rate": null,
  "gst": null
}

Check message, not the status code. Success means a rate was found.

Errors

This is the same API used for reverse pickups. To price a pickup from a customer, see Rate Calculator in Reverse Logistics, where service is reverse or reverse_qc.

See Get Rate for a Pincode Pair in the API Reference for the full schema.