For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DocumentationAPI ReferenceShipBob Logistics
DocumentationAPI ReferenceShipBob Logistics
  • ShipBob Logistics
    • ShipBob Logistics API
    • Rate Shopping
    • Webhooks
    • Sandbox
LogoLogo
On this page
  • Endpoint Details
  • Headers
  • Environments
  • Sample Requests
  • 1. Standard Ground
  • 2. Standard Premium
  • 3. ShipBob Economy
  • Sample Response
  • Troubleshooting
ShipBob Logistics

Rate Shopping API

||View as Markdown|
Was this page helpful?

Last updated February 24, 2026

Previous

ShipBob Logistics API

Next

ShipBob Logistics Webhook

Built with

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.