ShipBob Logistics

Rate Shopping API

View as Markdown

Endpoint Details

  • API URL: <baseurl>/api/rate-shopping
  • Method: POST

Headers

HeaderValue
Authorization<PAT token>
Content-Typeapplication/json

Note: All fields in the request are mandatory
The serviceName must be the name of your ship option in your ShipBob dashboard. For example, "Standard Ground", "Standard Premium", "TikTok FBM US Standard", etc.

Environments

  • Production: POST https://logisticslabelprintingapi.shipbob.com/api/rate-shopping
  • Stage: POST https://logisticslabelprintingapi-stage.shipbob.dev/api/rate-shopping

Sample Requests

1. Standard Ground

POST https://logisticslabelprintingapi.shipbob.com/api/rate-shopping
1{
2  "actualWeight": 16.5, //OUNCES
3  "packageDimensions": {
4    "LengthInches": 12.0,
5    "WidthInches": 8.0,
6    "HeightInches": 6.0
7  },
8  "destinationAddress": {
9    "address1": "123 Main Street",
10    "address2": null,
11    "city": "Chicago",
12    "state": "IL",
13    "zipCode": "60601",
14    "countryISO": "US"
15  },
16  "fulfillmentCenterId": "33",
17  "serviceName": "Standard Ground",
18  "hasSignature": true,
19  "insuranceAmount" : 200
20}

2. Standard Premium

POST https://logisticslabelprintingapi.shipbob.com/api/rate-shopping
1{
2  "actualWeight": 16.5, //OUNCES
3  "packageDimensions": {
4    "LengthInches": 12.0,
5    "WidthInches": 8.0,
6    "HeightInches": 6.0
7  },
8  "destinationAddress": {
9    "address1": "123 Main Street",
10    "address2": null,
11    "city": "Chicago",
12    "state": "IL",
13    "zipCode": "60601",
14    "countryISO": "US"
15  },
16  "fulfillmentCenterId": "33",
17  "serviceName": "Standard Premium",
18  "hasSignature": false,
19  "insuranceAmount" : 0
20}

3. ShipBob Economy

POST https://logisticslabelprintingapi.shipbob.com/api/rate-shopping
1{
2  "actualWeight": 16.5, //OUNCES
3  "packageDimensions": {
4    "LengthInches": 12.0,
5    "WidthInches": 8.0,
6    "HeightInches": 6.0
7  },
8  "destinationAddress": {
9    "address1": "123 Main Street",
10    "address2": null,
11    "city": "Chicago",
12    "state": "IL",
13    "zipCode": "60601",
14    "countryISO": "US"
15  },
16  "fulfillmentCenterId": "33",
17  "serviceName": "Standard Economy",
18  "hasSignature": false,
19  "insuranceAmount" : 0
20}

Sample Response

1{
2  "data":[
3    {
4      "surcharges":{
5        "isSuccess":false,
6        "errorMessage":"No surcharges found against estimate rates.",
7        "totalSurchargesAmount":0,
8        "surchargesCurrencyCode":null,
9        "surcharges":[]
10      },
11      "flatRate":7.6,
12      "flatRateCurrencyCode":"USD",
13      "shipOptionDisplayName":"Standard (Ground)",
14      "isSuccess":true,
15      "errorMessage":""
16    }
17  ],
18  "isSuccess":true,
19  "errorMessage":""
20}

Troubleshooting

  • Ensure you provide actualWeight and all packageDimensions (LengthInches, WidthInches, HeightInches)
    • actualWeight should be in ounces.
    • LengthInches, WidthInches, HeightInches should be in inches.
  • Pass a valid fulfillmentCenterId
    • For Stage, use 33
    • For Prod, fetch your fulfillmentCenterId via:
      GET https://api.shipbob.com/2026-01/fulfillment-center
  • Get your <PAT token> from the ShipBob dashboard by going to Integrations → API Tokens → Generate new token. Your ShipBob rep will also provide this.