Skip to main content

Rate Shopping

Compare shipping rates across all carriers in a single API call to find the best price, fastest transit, or optimal balance.

Basic rate request​

curl -X POST https://api.flexops.io/v1/rates \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "zip": "80202", "country": "US" },
    "to": { "zip": "97201", "country": "US" },
    "parcel": { "weightOz": 32, "lengthIn": 12, "widthIn": 10, "heightIn": 6 }
  }'

Rate response​

{
  "rates": [
    {
      "id": "rate_001",
      "carrier": "usps",
      "service": "ground_advantage",
      "amount": 7.50,
      "currency": "USD",
      "transitDays": 5,
      "deliveryDate": "2026-03-15"
    },
    {
      "id": "rate_002",
      "carrier": "usps",
      "service": "priority",
      "amount": 9.25,
      "currency": "USD",
      "transitDays": 2,
      "deliveryDate": "2026-03-12"
    },
    {
      "id": "rate_003",
      "carrier": "ups",
      "service": "ground",
      "amount": 11.40,
      "currency": "USD",
      "transitDays": 4,
      "deliveryDate": "2026-03-14"
    }
  ]
}

AI-powered recommendations​

Use the smart shipping endpoint for carrier recommendations based on historical performance data:

curl -X POST https://api.flexops.io/v1/shipping/recommend \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "originPostalCode": "80202",
    "destinationPostalCode": "97201",
    "weightOz": 32,
    "priority": "balanced"
  }'

Priority options: cost, speed, reliability, balanced (default).

The recommendation engine analyzes on-time rates, average transit times, exception rates, and seasonal patterns from your historical shipment data.