Shipping cost (dimensional weight) API

Compute parcel shipping cost using dimensional (volumetric) weight: dimWeight = L×W×H / divisor, billable = max(actual, dim), cost = billable × ratePerLb + handling, and which weight was billed. Deterministic carrier math. Answers 'what is my dimensional weight','shipping cost with dim weight','will I be billed actual or dimensional'.

Price$0.01per request

MethodPOST

Route/v1/calc/ecom-shipping-cost

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

ecomshippingdimensional-weightparcellogisticsfulfillmentecommercecalc

API URLhttps://x402.hexl.dev/v1/calc/ecom-shipping-cost

Integration docs

Example request

{
  "lengthIn": 12,
  "widthIn": 10,
  "heightIn": 8,
  "actualWeightLb": 3,
  "ratePerLb": 2.5,
  "dimDivisor": 139,
  "handling": 1
}

Example response

{
  "formula": "dimWeight = L×W×H / divisor; billable = max(actual, dim); cost = billable × ratePerLb + handling",
  "dimensionsIn": {
    "length": 12,
    "width": 10,
    "height": 8
  },
  "cubicInches": 960,
  "dimDivisor": 139,
  "dimWeightLb": 6.906,
  "actualWeightLb": 3,
  "billableWeightLb": 6.906,
  "billedOn": "dimensional",
  "shippingCost": 18.27
}

Input schema

{
  "type": "object",
  "required": [
    "lengthIn",
    "widthIn",
    "heightIn",
    "actualWeightLb",
    "ratePerLb"
  ],
  "properties": {
    "lengthIn": {
      "type": "number",
      "description": "Length (inches)",
      "examples": [
        12
      ]
    },
    "widthIn": {
      "type": "number",
      "description": "Width (inches)",
      "examples": [
        10
      ]
    },
    "heightIn": {
      "type": "number",
      "description": "Height (inches)",
      "examples": [
        8
      ]
    },
    "actualWeightLb": {
      "type": "number",
      "description": "Actual weight (lb)",
      "examples": [
        3
      ]
    },
    "ratePerLb": {
      "type": "number",
      "examples": [
        2.5
      ]
    },
    "dimDivisor": {
      "type": "number",
      "description": "Default 139 (domestic)",
      "examples": [
        139
      ]
    },
    "handling": {
      "type": "number",
      "examples": [
        1
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}