Container utilization calculator API

Compute how many cartons fit in a shipping container as floor(containerVolume·stowFactor / cartonVolume) capped by payload weight, with the binding constraint and cube utilization — deterministic container-loading math. Answers 'how many cartons fit in a 40ft container','is my load volume or weight limited','container cube utilization'.

Price$0.01per request

MethodPOST

Route/v1/calc/logi-container-utilization

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calclogisticsfreightcontainerutilizationcubeoceanloading

API URLhttps://x402.hexl.dev/v1/calc/logi-container-utilization

Integration docs

Example request

{
  "containerVolumeM3": 67,
  "cartonVolumeM3": 0.045
}

Example response

{
  "formula": "cartons = floor(containerVolume·stowFactor / cartonVolume), capped by payload; cubeUtil = usedVolume/containerVolume",
  "maxCartons": 1340,
  "limitingFactor": "volume",
  "usedVolumeM3": 60.3,
  "cubeUtilization": 0.9,
  "cubeUtilizationPercent": 90,
  "inputs": {
    "containerVolumeM3": 67,
    "containerPayloadKg": null,
    "cartonVolumeM3": 0.045,
    "cartonWeightKg": null,
    "stowFactor": 0.9
  }
}

Input schema

{
  "type": "object",
  "required": [
    "containerVolumeM3",
    "cartonVolumeM3"
  ],
  "properties": {
    "containerVolumeM3": {
      "type": "number",
      "description": "usable container volume (m³)",
      "examples": [
        67
      ]
    },
    "cartonVolumeM3": {
      "type": "number",
      "examples": [
        0.045
      ]
    },
    "containerPayloadKg": {
      "type": "number",
      "description": "optional max payload for weight cap",
      "examples": [
        1000
      ]
    },
    "cartonWeightKg": {
      "type": "number",
      "examples": [
        5
      ]
    },
    "stowFactor": {
      "type": "number",
      "description": "usable fraction of volume (0-1, default 0.9)",
      "examples": [
        0.9
      ]
    }
  }
}

Output schema

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