One endpoint. Full packing optimization.
StoaPack optimizes how items are packed into boxes across multiple warehouses. Send your items, boxes, and inventory — get back the optimal packing solution with exact placement coordinates, weight distribution, and hazmat compliance.
Make your first API call in under 5 minutes. Step-by-step with code examples in curl, Python, Node.js, and PHP.
Full interactive reference for every endpoint, parameter, and response field. Built from the OpenAPI spec.
Real-world scenarios with complete request/response pairs you can copy and adapt.
Authentication
All API requests require an API key passed in the X-API-Key header.
- Sign up for a StoaPack account
- Go to your Dashboard and create an API key
- Include it in every request:
curl -H "X-API-Key: YOUR_API_KEY" https://stoapack.stoalogistics.com/api/v1/healthBase URL
https://stoapack.stoalogistics.com/api/v1/
All endpoints are versioned under /api/v1/. The single optimization endpoint is:
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/optimize |
Run bin packing optimization |
| GET | /api/v1/health |
Health check (no auth required) |
How It Works
You send a JSON request with three things:
- Items — What you need to pack (dimensions, weight, quantity)
- Warehouses — Where your inventory is, and what boxes are available at each location
- Options — Units (inches or cm), optimization goal, AI custom instructions
StoaPack returns the optimal packing solution: which items go in which boxes at which warehouses, with exact 3D placement coordinates, weight totals, and compliance checks.