Troubleshooting

Authentication

Issue	Resolution
401 invalid API key	Send Authorization: Api-Key YOUR_KEY with a single space. See Authentication.
401 missing credentials	Include the Authorization header on every request.
403 on retrieve/list	Order or lane is outside your API key scope.

Create an order

Issue	Resolution
400 validation	Compare body to Air, LCL, and LTL or FCL and FTL for your transportation_mode ([POST] Create an order).
403 supplier or consignee	Names must match onboarded lanes (case-insensitive).
422 cargo fields	Air / LCL / LTL: shipment_skus only. FCL / FTL: non-empty containers; SKUs and/or pallets and boxes. order_items, order_containers, pre_builts and loose_boxes are accepted for the same fields.
400 duplicate field	A field was sent under both of its accepted names (for example shipment_skus and order_items). Send one or the other.
422 unknown SKU	SKU must exist in the item master unless lane bypass is enabled.

Packing instructions and webhooks

Issue	Resolution
400 on download	Optimization in progress; wait or use Event types.
Wrong order on download	Duplicate reference resolves to newest order; use alpha_ref ([GET] Retrieve an order).
Webhook signature failure	Verify signatures
Duplicate webhook events	Deduplicate on event id (Deliveries).