---
title: "CBM Calculator"
method: GET
path: "/api/cbm"
tags: ["Calculators"]
---

# CBM Calculator

`GET /api/cbm`

## Request

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

Calculate cubic metres (CBM), cubic feet, litres, and cubic inches from box dimensions.

## Query parameters

- `l` number, required
- `w` number, required
- `h` number, required
- `pcs` integer

## Response `200`

Successful CBM calculation.

- CbmResponse
  - `cbm_per_piece` number, required: Cubic metres per single piece.
  - `total_cbm` number, required: Total cubic metres for all pieces.
  - `total_volume_m3` number, required: Total volume in cubic metres (same as total_cbm).
  - `cubic_feet` number, required: Total volume in cubic feet.
  - `litres` number, required: Total volume in litres.
  - `cubic_inches` number, required: Total volume in cubic inches.
  - `pieces` integer, required: Number of pieces.
  - `meta` object, required
    - `inputs` CbmMetaInputs
      - `length_cm` number
      - `width_cm` number
      - `height_cm` number
      - `pieces` 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)