Get an order

Use the UUID returned by order creation or the path in its Location header.

Path parameter

Parameter	Type	Description
id	UUID	Public order identifier.

Response 200

{"id":"7c0c9a54-517c-4bbb-a946-bf14bf86c113","client_request_id":"order-1042","address":"TXYZ","energy":65000,"duration_hours":1,"total_trx":"3.200000","status":"delivered","lifecycle_final":false,"delivery_final":true,"created_at":1784376000,"updated_at":1784376012,"failure":null}

Field	Type	Description
status	string	created, executing, delivered, rental_finished, failed, or rental_interrupted.
lifecycle_final	boolean	The full rental is over and no further transition will happen.
delivery_final	boolean	The delivery attempt is over. true is not success by itself; inspect failure.
failure	object or null	Stable code and safe message for a failed result.
created_at, updated_at	integer	Unix seconds.

When to stop polling

Stop only when both final flags are true. A successful full lifecycle ends as rental_finished. failed and rental_interrupted include failure.

Not found

Missing and foreign-account IDs intentionally return the same response:

{"type":"https://rentron.xyz/docs/errors/codes#energy_order_not_found","title":"Not Found","status":404,"detail":"Order was not found.","code":"energy_order_not_found"}