Calculators

Chargeable Weight Calculator

Calculate the chargeable weight for air freight shipments by comparing actual gross weight against volumetric weight.

get/api/chargeable-weight

Request

  • Base URL: https://www.freightutils.com
  • URL: https://www.freightutils.com/api/chargeable-weight
  • Auth: none declared

Query parameters

lnumber required

Length in centimetres.

wnumber required

Width in centimetres.

hnumber required

Height in centimetres.

gwnumber required

Gross weight in kilograms of ALL pieces together (the total, not one piece); l/w/h are per piece.

pcsinteger

Number of pieces — a whole number from 1 to 9007199254740991 (default 1). Anything else, such as 2.5 or 1e+21, is refused with 400, never rounded.

factorinteger

Volumetric divisor in cm³ per kg — a whole number from 1 to 9007199254740991. Standard air freight is 6000 (default); express carriers typically use 5000.

mode'air' | 'sea'

Calculation mode: air (default) or sea (W/M at 1 CBM = 1 revenue tonne), in any case. Any other value is refused with 400 — it is never computed as air.

Response

Successful chargeable weight calculation.

chargeable_weight_kgnumber required

The chargeable weight (higher of actual vs volumetric).

basis'actual' | 'volumetric' required

Whether the chargeable weight is based on 'actual' gross weight or 'volumetric' weight.

gross_weight_kgnumber required

Actual gross weight in kg.

volumetric_weight_kgnumber required

Total volumetric weight in kg.

volumetric_weight_per_piece_kgnumber required

Volumetric weight per piece in kg.

cbmnumber required

Total cubic metres.

rationumber required

Weight-to-volume ratio (kg per CBM).

factorinteger required

Volumetric divisor factor used.

piecesinteger required

Number of pieces.

Example response

{
  "chargeable_weight_kg": 500,
  "basis": "actual",
  "gross_weight_kg": 500,
  "volumetric_weight_kg": 320,
  "volumetric_weight_per_piece_kg": 160,
  "cbm": 1.92,
  "ratio": 3.84,
  "factor": 6000,
  "pieces": 2,
  "meta": {
    "inputs": {
      "length_cm": 120,
      "width_cm": 80,
      "height_cm": 100,
      "gross_weight_kg": 500,
      "pieces": 2,
      "factor": 6000
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.