The Cold Cartonization API is an advanced extension of our standard Parcel Cartonization Software, built specifically for cold chain logistics. It helps developers determine the best packing configuration for temperature-sensitive products like chocolates, pharmaceuticals, and perishables by automatically including gel packs or ice packs when needed.
This HTTPS REST API uses smart cartonization logic to ensure cost efficiency and product safety during transport.
Every successful API response includes:
• Optimized packing recommendations
• Visualizations and animated demos
• Embeddable iFrame links for integration into dashboards or WMS applications
With this API, cold chain operations can stay compliant, reduce waste, and cut shipping costs using intelligent Cartonization Software.
How Developers Can Use the Cold Chain Cartonization API
-
Email us at tom@getperseuss.com to request one.
1. Request API KEY
To begin using the Perseuss API, you'll need an API key.
2. Make Your First API Call
Once you have your API key:
-
Send a POST request to this endpoint:
https://backend.perseuss.xyz/post-cold-cartonization
-
Use the request schema provided below to format your data correctly.
{
"api_key": "SEND_EMAIL_FOR_API_KEY",
"max_runtime_seconds": 30.0,
"ice_packs_per_box": [
{
"item_id": "ice_pack",
"quantity": 3,
"width_inches": 4,
"height_inches": 4,
"length_inches": 2,
"weight_oz_item": 8,
},
{
"item_id": "gel_pack",
"quantity": 1,
"width_inches": 6,
"height_inches": 3,
"length_inches": 3,
"weight_oz_item": 8,
},
],
"allowed_boxes": [
{
"box_name": "9x12x4",
"length_inches": 9,
"width_inches": 12,
"height_inches": 4,
"box_weight_lbs": 0.4,
"box_cost_usd": 0.25
},
{
"box_name": "9x12x6",
"length_inches": 9,
"width_inches": 12,
"height_inches": 6,
"box_weight_lbs": 0.5,
"box_cost_usd": 0.35
},
{
"box_name": "9x12x8",
"length_inches": 9,
"width_inches": 12,
"height_inches": 8,
"box_weight_lbs": 0.6,
"box_cost_usd": 0.45
},
{
"box_name": "9x12x10",
"length_inches": 9,
"width_inches": 12,
"height_inches": 10,
"box_weight_lbs": 0.7,
"box_cost_usd": 0.55
},
{
"box_name": "9x12x12",
"length_inches": 9,
"width_inches": 12,
"height_inches": 12,
"box_weight_lbs": 0.8,
"box_cost_usd": 0.65
},
{
"box_name": "12x12x12",
"length_inches": 12,
"width_inches": 12,
"height_inches": 12,
"box_weight_lbs": 1.0,
"box_cost_usd": 0.77
},
],
"items": [
{
"item_id": "frozen_pizza",
"quantity": 4,
"width_inches": 8.5,
"height_inches": 2,
"length_inches": 11,
"weight_oz_item": 24,
},
{
"item_id": "frozen_burger",
"quantity": 6,
"width_inches": 4,
"height_inches": 4,
"length_inches": 4,
"weight_oz_item": 16,
}
]
}
{
"response_status_code": 200,
"response_status_message": "HTTP 200 OK"
"response_body": {
"status": "SUCCESS",
"description": "The optimization process was successful and found 1 valid solutions in 13.790000 seconds",
"solutions": [
{
"status_code": 200,
"status": "OPTIMIZATION_COMPLETE",
"algorithm_name": "GREEDY(OBJECTIVE=CARTON_COST+COLD)",
"request_id": "e7cb97d2-52df-4b50",
"solution_id": "1b27d894-2375-46f3",
"total_carton_cost_usd": 1.1,
"total_item_quantity": 18,
"total_item_lines": 4,
"num_boxes": 2,
"full_box_list": [
"BOX_1",
"BOX_2"
],
"full_item_list": [
{
"item_id": "frozen_burger",
"quantity": 6
},
{
"item_id": "frozen_pizza",
"quantity": 4
},
{
"item_id": "(ICE)_ice_pack",
"quantity": 6
},
{
"item_id": "(ICE)_gel_pack",
"quantity": 2
}
],
"solution_details": {
"BOX_1": {
"box_name": "9x12x10",
"carton_cost_usd": 0.55,
"box_fill_rate": 0.67,
"box_weight_lbs": 9.5,
"visualization_link": "https://d3rzhiqfia1fmr.cloudfront.net/packing-visulization/7880d6ce-66cf-48b1",
"animation_link": "https://d3rzhiqfia1fmr.cloudfront.net/packing-animation/7880d6ce-66cf-48b1",
"item_quantities": {
"(ICE)_gel_pack": 1,
"(ICE)_ice_pack": 3,
"frozen_burger": 6,
"frozen_pizza": 1
}
},
"BOX_2": {
"box_name": "9x12x10",
"carton_cost_usd": 0.55,
"box_fill_rate": 0.66,
"box_weight_lbs": 6.5,
"visualization_link": "https://d3rzhiqfia1fmr.cloudfront.net/packing-visulization/4fb77e42-4b22-4899",
"animation_link": "https://d3rzhiqfia1fmr.cloudfront.net/packing-animation/4fb77e42-4b22-4899",
"item_quantities": {
"(ICE)_gel_pack": 1,
"(ICE)_ice_pack": 3,
"frozen_pizza": 3
}
}
}
}
]
}
}