Booking status by your own reference

no capability gate

The supported way to collect an AWB after POST /v1/shipping/book answers 202. Poll this, not the order row — awb_number on the pending-order table is never populated, by design.

state is one of booked (done; awb_number and courier are filled), booking_in_progress (still on the worker — poll again in a few seconds), failed (it will not complete, and failure_reason says why in plain words), or not_shipped (the order exists, no ship was requested).

Back off to every 10–15 seconds. A booking unsettled after a couple of minutes has almost certainly failed, and the response will say so.

Parameters

Name	In	Type	Description
order_norequired	query	string	Your own reference, exactly as you sent it on create.

Responses

Status	Meaning
200	`{order_no, state, awb_number, courier, status, failure_reason, created_at}`.
400 `order_no is required`	The query parameter is absent or empty.
404 `order_not_found`	No order with that reference on your account. Never means "not booked yet".