Rating

Most carriers have the ability to request all rates for a given origin/destination pair or a single rate. Since these API calls take the same amount of time to complete and to provide carrier consistency, RocketShipIt only provides the ability to request all rates. If you are looking for a single rate simply filter out the unwanted rates from the response.

For most carriers if a rate/service is not available in that region it will not be returned.

Some carriers will even selectively remove rates for you based on estimated delivery time.

Request#

A rating request will typically have the following parameters:

{
  "carrier": "UPS-REST",
  "action": "GetAllRates",
  "params": {
    "key": "YOUR_UPS_API_KEY",
    "account_number": "YOUR_ACCOUNT_NUMBER",
    "packages": [
      {
        "weight": 5,
        "length": 5,
        "width": 5,
        "height": 5
      }
    ],
    "customs": [],
    "shipper": "RocketShipIt",
    "ship_addr1": "123 Main St",
    "ship_city": "Whitehall",
    "ship_state": "MT",
    "ship_code": "59759",
    "ship_country": "US",
    "to_country": "US",
    "to_code": "90210",
    "weight_unit": "LBS",
    "pickup_type": "01",
    "customer_classification": "01",
    "length_unit": "IN",
    "packaging_type": "02"
  }
}

Future ship dates#

By default rate quotes and their transit/delivery estimates are anchored to the current date. To rate a shipment you plan to ship later, pass ship_date in params as YYYY-MM-DD or an RFC3339 timestamp such as 2026-08-28T14:30:00Z. Most carriers support this, including UPS, FedEx, USPS and DHL. For DHL, pickup_date is accepted as an alias and ready_time (HHMM) sets the time the shipment is ready, matching the time-in-transit action. Note that carriers only accept dates a limited distance in the future; DHL rejects dates more than about 10 days out.

Response#

See: GetAllRates Response Format for the GetAllRates Action

API Examples#

See: API Examples