Skip to content
HALOWERK

Ortwerk

parcel dg check

Battery ratings are checked against the limits DHL publishes for ADR special provision 188 (Li-ion ≤ 20 Wh per cell and ≤ 100 Wh per battery, Li-metal ≤ 1 g per cell and ≤ 2 g per battery; Wh computed from V × mAh when needed). DHL Paket national (Infoblatt 07/2025, Regelungen Teil 2): limited quantities and SP 188 batteries allowed with conditions (packaging, short-circuit and activation protection, lithium mark for loose batteries and from three devices, max. 30 kg gross), e-bike batteries.

POST https://ort.halowerk.com/v1/parcel-dg-check

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
carriersarrayNo
destination_countrystringNoISO 3166-1 alpha-2 country code.
gross_weight_kgnumberNoGross weight of the package.
dpd_dg_agreementbooleanNoSender has a DPD „Sondervereinbarung Gefahrgut“.
itemsarrayYes
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "items"
  ],
  "properties": {
    "carriers": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {
        "enum": [
          "dhl",
          "hermes",
          "dpd"
        ]
      }
    },
    "destination_country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code.",
      "default": "DE"
    },
    "gross_weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 70,
      "description": "Gross weight of the package."
    },
    "dpd_dg_agreement": {
      "type": "boolean",
      "default": false,
      "description": "Sender has a DPD „Sondervereinbarung Gefahrgut“."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "kind"
        ],
        "properties": {
          "kind": {
            "enum": [
              "lithium_ion",
              "lithium_metal",
              "sodium_ion",
              "vehicle_lithium_battery",
              "aerosol",
              "perfume_or_nail_polish",
              "flammable_liquid_other",
              "lighter",
              "matches",
              "fireworks",
              "ammunition",
              "airbag",
              "dry_ice",
              "co2_cylinder",
              "fire_extinguisher",
              "lead_acid_spillable",
              "lead_acid_non_spillable",
              "smoke_detector_ionizing"
            ]
          },
          "packing": {
            "enum": [
              "loose",
              "with_equipment",
              "in_equipment",
              "in_vehicle"
            ],
            "description": "For batteries."
          },
          "wh_per_battery": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000
          },
          "wh_per_cell": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000
          },
          "voltage_v": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 1000
          },
          "capacity_mah": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 10000000
          },
          "lithium_g_per_battery": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000
          },
          "lithium_g_per_cell": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000
          },
          "cells": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10000
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000,
            "default": 1
          },
          "damaged": {
            "type": "boolean",
            "default": false
          },
          "shorted_no_energy": {
            "type": "boolean"
          },
          "volume_ml": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 100000,
            "description": "Per container (aerosols, liquids)."
          },
          "toxic": {
            "type": "boolean",
            "default": false
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "items": [
    {
      "kind": "lithium_ion",
      "packing": "in_equipment",
      "voltage_v": 3.85,
      "capacity_mah": 4500,
      "cells": 1
    }
  ],
  "destination_country": "DE"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →