Hazmat-Aware 3D Bin Packing API

Automatic 49 CFR and IATA DGR compliance. Just add a UN number to your items—we handle the rest.

The Hazmat Challenge

Segregation Rules

Incompatible materials like oxidizers and flammables cannot be packed together - a violation can cause fires or explosions.

Complex Regulations

49 CFR for ground, IATA DGR for air - different rules, quantity limits, and packaging requirements for each mode.

Costly Fines

Non-compliance can result in fines up to $250,000 per violation, shipment delays, and reputational damage.

Manual Classification

Looking up UN numbers, hazard classes, and packing groups for every item slows down fulfillment operations.

What StoaPack Does

Just add hazmat_un to your items. That's it.

Our built-in UN reference database automatically populates the hazard class, packing group, proper shipping name, and all regulatory constraints. No need to memorize regulations or maintain your own hazmat database.

  • Auto-Classification: UN number lookup handles everything
  • Smart Segregation: Incompatible materials automatically separated
  • Mode-Specific Rules: Ground, air, and sea shipping constraints applied
  • Packing Group Enforcement: PG I/II/III severity levels respected
Simple API Request
{
  "items": [
    {
      "id": "aerosol-spray",
      "width": 5, "height": 15, "depth": 5,
      "weight": 0.3,
      "hazmat_un": "UN1950"
    },
    {
      "id": "lithium-battery",
      "width": 10, "height": 8, "depth": 3,
      "weight": 0.5,
      "hazmat_un": "UN3481"
    }
  ],
  "shipping_mode": "ground",
  "warehouses": [...]
}

Core Capabilities

Segregation Matrix

Oxidizers kept separate from flammables. Explosives isolated. Corrosives away from water-reactive materials. All automatic.

Orientation Control

Liquids (Class 3, 8) automatically flagged for upright orientation to prevent leaks during transport.

Fill Ratio Limits

Explosives limited to 70% fill, oxidizers to 75%. Ensures safe packaging with proper cushioning space.

Shipping Mode Rules

IATA quantity limits for air, 49 CFR for ground, IMDG for sea. Constraints applied based on your shipping mode.

How It Works

1

Add UN Numbers

Include hazmat_un field on any item containing hazardous materials

2

We Validate

Auto-classify hazard class, apply segregation rules, enforce quantity limits

3

Get Compliant Packing

Receive packing solution with hazmat summary and any compliance warnings

Tiered Quantity Limit Enforcement

Flexible compliance from basic to full regulatory control.

Our system supports three tiers of quantity limit enforcement, allowing you to choose the level of precision that fits your operations:

Tier 1: UN Number Only

Just provide hazmat_un. We estimate quantity from item weight with conservative safety margins (70-85% of limits).

Tier 2: Explicit Quantity

Add hazmat_net_quantity and hazmat_net_quantity_unit for 100% of regulatory limits with precise control.

Tier 3: Full Compliance

Include packing group and shipping category for complete 49 CFR and IATA DGR regulatory compliance.

Tier 2 Example: Explicit Quantity
{
  "items": [
    {
      "id": "paint-can",
      "width": 10, "height": 15, "depth": 10,
      "weight": 1.5,
      "hazmat_un": "UN1263",
      "hazmat_net_quantity": 1000,
      "hazmat_net_quantity_unit": "mL"
    }
  ],
  "shipping_mode": "air"
}
Air Transport Q-Value Calculation

For air shipments, we calculate Q-values per IATA DGR 5.0.2.11:

  • Sum of (net quantity / max allowed) for all items
  • Rounds UP to nearest 0.1 per IATA spec
  • Warning triggered if Q-value exceeds 1.0

Comprehensive Hazard Class Coverage

Class 2: Gases Class 3: Flammable Liquids Class 4: Flammable Solids Class 5: Oxidizers Class 6: Toxic Class 8: Corrosives Class 9: Miscellaneous

Built-in UN Reference Database

Our database covers 24+ common hazmat items including:

  • UN1950 - Aerosols, flammable
  • UN1203 - Gasoline
  • UN1263 - Paint
  • UN1789 - Hydrochloric acid
  • UN1830 - Sulfuric acid
  • UN2031 - Nitric acid
  • UN3481 - Lithium ion batteries
  • UN3480 - Lithium ion batteries (standalone)
  • UN1075 - LPG
  • UN1072 - Oxygen, compressed
  • UN2794 - Lead-acid batteries
  • UN1942 - Ammonium nitrate

Real-World Scenarios

E-Commerce: Lithium Batteries

Shipping electronics with lithium batteries? Just add hazmat_un: "UN3481" to battery-containing items.

System automatically applies IATA Section II limits for air shipping and ensures batteries are properly documented.

Industrial: Paint & Solvents

Mixed order with paint (UN1263) and oxidizer-based cleaners? Our segregation matrix keeps them in separate packages.

Flammables and oxidizers are automatically placed in different segregation groups to prevent dangerous reactions.

Chemical Supply: Acids

Shipping hydrochloric acid (UN1789) with sulfuric acid (UN1830)? Both are Class 8 corrosives - compatible for same package.

Same-class materials are intelligently grouped together, reducing package count while maintaining compliance.

API Response with Hazmat Summary

{
  "solution": { ... },
  "hazmat_summary": {
    "total_hazmat_packages": 3,
    "segregation_groups_created": 2,
    "incompatibilities_resolved": [
      {
        "item1_id": "paint-thinner",
        "item1_un": "UN1263",
        "item2_id": "pool-chlorine",
        "item2_un": "UN2880",
        "reason": "Class 3 (Flammable) incompatible with Class 5.1 (Oxidizer)"
      }
    ],
    "quantity_data": {
      "q_value": 0.8,
      "data_quality_confidence": "HIGH",
      "effective_limit_percentage": 100
    },
    "warnings": [
      "QUANTITY_ESTIMATED: Using weight_as_volume for UN1263. Provide hazmat_net_quantity for precise compliance."
    ],
    "shipping_restrictions": ["Air shipping: quantity limits per IATA Section II"]
  }
}

Ready to Simplify Hazmat Compliance?

Stop worrying about segregation rules and regulatory fines. Let StoaPack handle the complexity.