Estimate a Rate

You can estimate a rate by providing a subset of the information required to create a label. You can use this to allow customers to quickly compare rates across services, carriers, and more without having to fill in all the information required to create a label.

It can also be useful to quickly estimate a rate so that you can add shipping charges to your customer's shopping cart. This allows you to offset some or all of the shipping costs to the customer at checkout. You can then use the customer's full address to get a rate and create a label at a later time. Alternately, you could provide the estimate at checkout and then create your labels in bulk when you get ready to package your shipments.

ShipEngine can provide a good estimate by using:

Note This endpoint does not support shipments that contain multiple packages or filtering using the rate_options property. You can filter by carrier using the carrier_ids property.

Example Request

POST /v1/rates/estimate

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
POST /v1/rates/estimate HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "carrier_ids": [
    "se-123890"
  ],
  "from_country_code": "US",
  "from_postal_code": "78756",
  "to_country_code": "US",
  "to_postal_code": "95128",
  "to_city_locality": "San Jose",
  "to_state_province": "CA",
  "weight": {
    "value": 1.0,
    "unit": "ounce"
  },
  "dimensions": {
    "unit": "inch",
    "length": 5.0,
    "width": 5.0,
    "height": 5.0
  },
  "confirmation": "none",
  "address_residential_indicator": "no"
}