API Overview¶
Integrate shipment ordering and packing optimization into your systems. Submit orders, run optimization, and retrieve packing instructions through a single REST API.
API Base URLs¶
Use the base URL that matches your environment:
|
Environment |
Base URL |
Portal |
|---|---|---|
|
Production |
|
|
|
Sandbox |
|
Important
Onboarding must be completed before creating orders. Supplier, consignee, items, boxes, pallets, and packing specifications must be configured in the ALPHA Portal. Contact your point of contact if anything is missing.
Note
Use Sandbox for testing. It mirrors Production but uses separate data. Switch to Production when ready to create live orders.
Quick Start Guide¶
-
Obtain an API key — Log in to the ALPHA Portal → API Keys → Generate Key
-
Add authentication — Include
Authorization: Api-Key <your-key>in every request -
Submit an order — POST to the submit-order endpoint with your payload
Typical Order Flow¶
-
Submit — POST your order payload to create the order
-
Processing — The optimizer runs. The PI is emailed to defined recipients, or fetch it via Download Packing Instructions.
-
Optional — Use Get Order by ID or List All Orders to check status
See API Authentication for full details.