Rate Shopping API

​

Endpoint Details

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

​

Headers

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

{
  "actualWeight": 16.5, //OUNCES
  "packageDimensions": {
    "LengthInches": 12.0,
    "WidthInches": 8.0,
    "HeightInches": 6.0
  },
  "destinationAddress": {
    "address1": "123 Main Street",
    "address2": null,
    "city": "Chicago",
    "state": "IL",
    "zipCode": "60601",
    "countryISO": "US"
  },
  "fulfillmentCenterId": "10",
  "serviceName": "Standard Ground",
  "hasSignature": true,
  "insuranceAmount" : 200
}

​

2. Standard Premium

{
  "actualWeight": 16.5, //OUNCES
  "packageDimensions": {
    "LengthInches": 12.0,
    "WidthInches": 8.0,
    "HeightInches": 6.0
  },
  "destinationAddress": {
    "address1": "123 Main Street",
    "address2": null,
    "city": "Chicago",
    "state": "IL",
    "zipCode": "60601",
    "countryISO": "US"
  },
  "fulfillmentCenterId": "10",
  "serviceName": "Standard Premium",
  "hasSignature": false,
  "insuranceAmount" : 0
}

​

Sample Response

{
  "data":[
    {
      "surcharges":{
        "isSuccess":false,
        "errorMessage":"No surcharges found against estimate rates.",
        "totalSurchargesAmount":0,
        "surchargesCurrencyCode":null,
        "surcharges":[]
      },
      "flatRate":7.6,
      "flatRateCurrencyCode":"USD",
      "shipOptionDisplayName":"Standard (Ground)",
      "isSuccess":true,
      "errorMessage":""
    }
  ],
  "isSuccess":true,
  "errorMessage":""
}

​

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 or 19
  • For Prod, fetch your fulfillmentCenterId via:
    GET https://api.shipbob.com/2025-07/fulfillmentCenter
• Get your <PAT token> from the ShipBob dashboard by going to Integrations → API Tokens → Generate new token. Your ShipBob rep will also provide this.