{"slug":"pack-api-williamrobinson-dev-v1-pack-plan-ef7052","title":"Plan a validated 3D carton packing arrangement for a set of items into one or mo","host":"pack.api.williamrobinson.dev","method":"POST","resource":"https://pack.api.williamrobinson.dev/v1/pack/plan","category":"code","description":"Plan a validated 3D carton packing arrangement for a set of items into one or more carton types, and return per-carton placements, a packing sequence, actual/dimensional/billable weight, a utilization and support/containment audit, and downloadable artifacts (a packing list, the full JSON report, an","price_listed":0.05,"price_asked":0.05,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":529,"reported_calls_30d":2,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"cartons":[{"available":10,"cost":0.9,"id":"small-box","innerDimensions":[30,22,18],"label":"Small shipping box","maxWeight":10,"tareWeight":0.3},{"available":6,"cost":1.6,"id":"medium-box","innerDimensions":[32,24,18],"label":"Medium shipping box","maxWeight":20,"tareWeight":0.6}],"dimensionalDivisor":5000,"items":[{"dimensions":[24,16,4],"fragile":false,"id":"book-hardcover","label":"Hardcover book","quantity":4,"rotation":"any","weight":0.9},{"dimensions":[12,9,9],"fragile":true,"id":"ceramic-mug","label":"Ceramic mug","maxLoad":0.5,"quantity":6,"rotation":"upright","weight":0.35},{"dimensions":[16,8,2],"fragile":false,"group":"accessories","id":"phone-case","label":"Phone case","quantity":12,"rotation":"any","weight":0.08}],"objective":"fewest-cartons","units":{"length":"cm","weight":"kg"}},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"$defs":{"dimensions3":{"description":"[length, width, height] in the request's length unit; each value is positive and at most the equivalent of 10 m.","items":{"exclusiveMinimum":0,"type":"number"},"maxItems":3,"minItems":3,"type":"array"},"rotation":{"enum":["any","upright","none"],"type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"cartons":{"items":{"additionalProperties":false,"properties":{"available":{"minimum":1,"type":"integer"},"cost":{"minimum":0,"type":"number"},"id":{"pattern":"^[A-Za-z0-9_.:-]{1,64}$","type":"string"},"innerDimensions":{"$ref":"#/properties/input/properties/body/$defs/dimensions3"},"label":{"maxLength":120,"minLength":1,"type":"string"},"maxWeight":{"description":"In the request's weight unit. The gram-equivalent (value converted via units.weight) must not exceed 1000000000 g (~1000 t); enforced exactly server-side.","exclusiveMinimum":0,"maximum":1000000000,"type":"number"},"tareWeight":{"description":"In the request's weight unit. The gram-equivalent (value converted via units.weight) must not exceed 1000000000 g (~1000 t); enforced exactly server-side.","maximum":1000000000,"minimum":0,"type":"number"}},"required":["id","innerDimensions","maxWeight"],"type":"object"},"maxItems":20,"minItems":1,"type":"array"},"dimensionalDivisor":{"default":5000,"description":"Volumetric divisor in cm^3/kg (5000 = UPS/FedEx/USPS/DHL as of 2026).","maximum":20000,"minimum":1000,"type":"number"},"items":{"items":{"additionalProperties":false,"properties":{"dimensions":{"$ref":"#/properties/input/properties/body/$defs/dimensions3"},"fragile":{"type":"boolean"},"group":{"pattern":"^[A-Za-z0-9_.:-]{1,64}$","type":"string"},"id":{"pattern":"^[A-Za-z0-9_.:-]{1,64}$","type":"string"},"label":{"maxLength":120,"minLength":1,"type":"string"},"maxLoad":{"description":"In the request's weight unit. The gram-equivalent (value converted via units.weight) must not exceed 1000000000 g (~1000 t); enforced exactly server-side.","maximum":1000000000,"minimum":0,"type":"number"},"quantity":{"maximum":500,"minimum":1,"type":"integer"},"rotation":{"$ref":"#/properties/input/properties/body/$defs/rotation"},"weight":{"description":"In the request's weight unit. The gram-equivalent (value converted via units.weight) must not exceed 1000000000 g (~1000 t); enforced exactly server-side.","maximum":1000000000,"minimum":0,"type":"number"}},"required":["id","dimensions","weight","quantity"],"type":"object"},"maxItems":200,"minItems":1,"type":"array"},"objective":{"default":"fewest-cartons","enum":["fewest-cartons","lowest-billable-weight","lowest-cost"],"type":"string"},"units":{"additionalProperties":false,"properties":{"length":{"enum":["mm","cm","in"],"type":"string"},"weight":{"enum":["g","kg","oz","lb"],"type":"string"}},"required":["length","weight"],"type":"object"}},"required":["units","items","cartons"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"$defs":{"check":{"additionalProperties":false,"properties":{"code":{"type":"string"},"detail":{"maxLength":2048,"type":"string"},"status":{"enum":["passed","failed","not_checked"],"type":"string"}},"required":["code","status","detail"],"type":"object"},"dimensions3":{"description":"[length, width, height] in the request's length unit; each value is positive and at most the equivalent of 10 m.","items":{"exclusiveMinimum":0,"type":"number"},"maxItems":3,"minItems":3,"type":"array"},"placement":{"additionalProperties":false,"properties":{"itemId":{"type":"string"},"orientation":{"maximum":5,"minimum":0,"type":"integer"},"origin":{"$ref":"#/properties/output/properties/example/$defs/point3"},"size":{"$ref":"#/properties/output/properties/example/$defs/dimensions3"},"step":{"minimum":1,"type":"integer"},"supportRatio":{"maximum":1,"minimum":0,"type":"number"},"unit":{"minimum":0,"type":"integer"}},"required":["itemId","unit","step","origin","size","orientation","supportRatio"],"type":"object"},"point3":{"description":"[x, y, z] min-corner coordinates in the request's length unit, relative to the carton's inner floor corner.","items":{"minimum":0,"type":"number"},"maxItems":3,"minItems":3,"type":"array"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"artifacts":{"items":{"additionalProperties":false,"properties":{"href":{"format":"uri","type":"string"},"mediaType":{"maxLength":128,"minLength":1,"type":"string"},"name":{"enum":["packing.json","packing-list.csv","preview.svg","preview.png"],"type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"sizeBytes":{"minimum":0,"type":"integer"}},"required":["name","mediaType","sizeBytes","sha256","href"],"type":"object"},"maxItems":4,"type":"array"},"cartons":{"items":{"additionalProperties":false,"properties":{"actualWeight":{"minimum":0,"type":"number"},"billableWeight":{"minimum":0,"type":"number"},"cartonId":{"type":"string"},"checks":{"items":{"$ref":"#/properties/output/properties/example/$defs/check"},"type":"array"},"contentsWeight":{"minimum":0,"type":"number"},"dimensionalWeight":{"minimum":0,"type":"number"},"id":{"type":"string"},"innerDimensions":{"$ref":"#/properties/output/properties/example/$defs/dimensions3"},"placements":{"items":{"$ref":"#/properties/output/properties/example/$defs/placement"},"maxItems":100,"type":"array"},"volumeUtilization":{"maximum":1,"minimum":0,"type":"number"}},"required":["id","cartonId","innerDimensions","placements","contentsWeight","actualWeight","dimensionalWeight","billableWeight","volumeUtilization","checks"],"type":"object"},"maxItems":100,"type":"array"},"checks":{"items":{"$ref":"#/properties/output/properties/example/$defs/check"},"type":"array"},"expiresAt":{"format":"date-time","type":"string"},"limitations":{"items":{"maxLength":4096,"type":"string"},"maxItems":16,"type":"array"},"recommendations":{"items":{"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"maxLength":2048,"type":"string"}},"required":["code","message"],"type":"object"},"maxItems":100,"type":"array"},"status":{"enum":["passed","failed"],"type":"string"},"summary":{"additionalProperties":false,"properties":{"averageUtilization":{"maximum":1,"minimum":0,"type":"number"},"cartonsUsed":{"minimum":0,"type":"integer"},"totalActualWeight":{"minimum":0,"type":"number"},"totalBillableWeight":{"minimum":0,"type":"number"},"totalCost":{"minimum":0,"type":"number"},"unitsPacked":{"minimum":0,"type":"integer"},"unitsRequested":{"minimum":0,"type":"integer"}},"required":["unitsRequested","unitsPacked","cartonsUsed","totalActualWeight","totalBillableWeight","totalCost","averageUtilization"],"type":"object"},"tools":{"additionalProperties":false,"properties":{"solver":{"type":"string"}},"required":["solver"],"type":"object"},"truncated":{"type":"boolean"},"units":{"additionalProperties":false,"properties":{"length":{"enum":["mm","cm","in"],"type":"string"},"weight":{"enum":["g","kg","oz","lb"],"type":"string"}},"required":["length","weight"],"type":"object"},"unpacked":{"items":{"additionalProperties":false,"properties":{"itemId":{"type":"string"},"reason":{"maxLength":2048,"type":"string"},"units":{"minimum":1,"type":"integer"}},"required":["itemId","units","reason"],"type":"object"},"maxItems":100,"type":"array"},"warnings":{"items":{"maxLength":4096,"type":"string"},"maxItems":100,"type":"array"}},"required":["status","tools","units","summary","cartons","unpacked","checks","warnings","recommendations","limitations","truncated","expiresAt","artifacts"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.05,"price_match":true,"latency_ms":529,"error":null}],"description_full":"Plan a validated 3D carton packing arrangement for a set of items into one or more carton types, and return per-carton placements, a packing sequence, actual/dimensional/billable weight, a utilization and support/containment audit, and downloadable artifacts (a packing list, the full JSON report, and an SVG/PNG preview)","last_updated":"2026-09-11T00:11:08.66Z","schemes":["exact"]}