Skip to Content
ShipmentsRates

Shipping Rates

Orderly’s rate engine lets you compare shipping rates across all connected carrier accounts in a single request.

Getting Rates

Via the Portal

When creating a shipment from an order, rates are automatically fetched and displayed for comparison.

Via the API

POST /api/rates
Content-Type: application/json
 
{
  "carrierAccountIds": ["uuid-1", "uuid-2"],
  "shipFrom": {
    "zip": "07001",
    "country": "US"
  },
  "shipTo": {
    "zip": "90210",
    "country": "US"
  },
  "weight": { "value": 5, "unit": "lb" },
  "dimensions": { "length": 12, "width": 8, "height": 6, "unit": "in" }
}

Response

{
  "data": {
    "rates": [
      {
        "carrierAccountId": "uuid-1",
        "carrier": "fedex",
        "service": "fedex_ground",
        "serviceName": "FedEx Ground",
        "totalPrice": 12.50,
        "currency": "USD",
        "estimatedDays": 5,
        "estimatedDelivery": "2026-03-21"
      },
      {
        "carrierAccountId": "uuid-1",
        "carrier": "fedex",
        "service": "fedex_express",
        "serviceName": "FedEx Express",
        "totalPrice": 28.75,
        "currency": "USD",
        "estimatedDays": 2,
        "estimatedDelivery": "2026-03-18"
      }
    ]
  }
}

Rate Factors

Rates are calculated based on:

  • Weight — Actual weight of the package
  • Dimensions — For dimensional weight pricing
  • Origin/Destination — Shipping zones
  • Service level — Ground, Express, Priority, etc.
  • Package type — Box, envelope, pallet
  • Carrier account — Negotiated rates per account

Multi-Carrier Comparison

Pass multiple carrierAccountIds to compare rates across carriers. The response includes all available rates sorted by price.

MFAPickups