---
title: "Chargeable Weight Calculator"
method: GET
path: "/api/chargeable-weight"
tags: ["Calculators"]
---

# Chargeable Weight Calculator

`GET /api/chargeable-weight`

## Request

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

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

## Query parameters

- `l` number, required
- `w` number, required
- `h` number, required
- `gw` number, required
- `pcs` integer
- `factor` integer
- `mode` 'air' | 'sea'

## Response `200`

Successful chargeable weight calculation.

- ChargeableWeightResponse
  - `chargeable_weight_kg` number, 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_kg` number, required: Actual gross weight in kg.
  - `volumetric_weight_kg` number, required: Total volumetric weight in kg.
  - `volumetric_weight_per_piece_kg` number, required: Volumetric weight per piece in kg.
  - `cbm` number, required: Total cubic metres.
  - `ratio` number, required: Weight-to-volume ratio (kg per CBM).
  - `factor` integer, required: Volumetric divisor factor used.
  - `pieces` integer, required: Number of pieces.
  - `meta` object, required
    - `inputs` ChargeableWeightMetaInputs
      - `length_cm` number
      - `width_cm` number
      - `height_cm` number
      - `gross_weight_kg` number
      - `pieces` integer
      - `factor` integer
  - `_source` SourceEnvelope: Additive provenance citation for the dataset or method behind this response, from FreightUtils' single provenance source of truth. Shapes: reference, methodology (calculators), or reference with provenance_status:'pending-verification'. Fields appear only when a real value exists.
    - `type` 'reference' | 'methodology', required
    - `authority` string
    - `dataset` string
    - `source_url` string
    - `data_vintage` string
    - `licence` string
    - `retrieved_via` string
    - `standard` string
    - `reference` string
    - `computed_by` string
    - `provenance_status` 'pending-verification'
    - `dataset_edition` string: Edition this response is served from (editioned reference datasets only), e.g. 'UN/LOCODE 2025-1'.
    - `authority_current_edition` string: The authority's current in-force edition at the last check. Differs from dataset_edition only when the served data lags the authority.
    - `checked_at` string: YYYY-MM-DD of the last served-vs-authority edition comparison (on-demand checker, staleness-guarded).

## Other responses

- `400`: Invalid or missing parameters.

---

[API](https://skmtc.dev/freightutils/apis/freightutils-api.md) · [All operations](https://skmtc.dev/freightutils/apis/freightutils-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freightutils/apis/freightutils-api/revisions/6607bb3cea90?raw)