Faster.Leaner.Smarter.

This is a live connection to our Packem API. You can modify Request Input to test different configurations.

The Raw Request Output shows the structured JSON solution, while the Visual Request Output renders the packing layout.

1. Items and Bins

• Items: Each item must have id, length, width, and height (double).
  • Optional: weight (double), label (string).
• Bins: Each bin must have id. For most objectives, bins should also include length, width, and height (double).
  • Optional: fixed_cost (double), tare_weight (double), quantity (integer).

2. Objectives

The objective (string) field controls what the packing algorithm tries to optimize. Supported options:

• minimise_bins: Use the smallest number of bins possible.
• minimise_unused_space: Minimize empty space inside used bins.
• maximise_items: Fit as many items as possible into limited bins.
• minimise_bin_costs: Optimize packing to minimize total bin fixed cost (fixed_cost).
• minimise_total_cost: Optimize packing to minimize total shipping cost using cost_model.
• minimise_bounding_box: Find the smallest bounding box that can contain all items (bins can be omitted).
• minimise_missing_height: Given fixed base (length/width), find the minimum required height (bin height can be omitted).

3. Constraints

The constraints (object) field defines the rules and restrictions the packing algorithm must follow.

3.1 Rotation

Field: rotation (boolean, optional) determines if items are allowed to rotate.
If omitted, rotation is allowed by default.

3.2 Fragility

Field: fragility (array of item IDs) specifies which items are fragile. Fragile items should not have other items stacked on top of them.

3.3 Weight Distribution

Field: weight_distribution (object) controls how weight is distributed within bins.
Weights are read from each item’s weight field (if omitted, weight defaults to 0). Subfields include:

• max_per_layer (double): limits total weight per horizontal layer.
• footprint (double): limits vertical load per footprint/cell.
• center_of_gravity (boolean): enforces stable center-of-gravity support.
• min_support_ratio (double in [0,1]): requires a minimum supported base area fraction.

3.4 Forbidden Adjacency

Field: forbidden_adjacency (array of item label pairs) defines which categories of items cannot be packed together in the same bin.
Categories are taken from each item’s label (if omitted, the label defaults to "default").

3.5 Priority Items

Field: priority (array of item IDs) indicates items that should be packed first or given higher priority.

4. Cost Model (for minimise_total_cost only)

Instead of extra, the current API uses a cost_model object when objective = "minimise_total_cost".

• ship_base (double): base shipping cost per used bin.
• ship_rate_per_kg (double): cost per kg (uses item weights + bin tare weight if provided).
• dim_divisor (double): dimensional weight divisor (0 disables dimensional weight).
• dunnage_cost_per_volume (double): penalty per unit unused volume.