Skip to main content

Customs goods unit - new field for Shipments

· One min read

unit is an new optional field which has been added to the customs.goods array in Shipment creation requests. This field allows you to specify the unit of measurement for the quantity of goods in your customs declarations.

Supported Units​

  • piece (pieces) - default value
  • m2 (square meters) - UPS shipments only for now

We expect to add support for more units in the future, on multiple carriers. Follow the progression on Product news

Key Changes​

  • The quantity field now accepts floating-point values to support precise measurements across different units
  • The unit field is optional and defaults to piece if not specified
  • Existing requests without the unit field will continue to work unchanged

For detailed information, see the Create a shipment API reference.

Example​

Customs goods segment of Request body​

{
  ...
  "customs": {
    ...
    "goods": [
      {
        "quantity": 1.0,
        "unit": "piece",
        "country_code": "DK",
        "content": "Cotton crewneck tunic blouse (knitted)",
        "commodity_code": "61061000",
        "unit_value": 149.99,
        "unit_weight": 300
      },
      {
        "quantity": 1.5,
        "unit": "m2",
        "country_code": "DK",
        "content": "Sea grass area rug (hand-woven)",
        "commodity_code": "57025090",
        "unit_value": 333.33,
        "unit_weight": 750
      }
    ]
  }
}