GET

Get an order

/api/v1/energy/orders/:order_id

Fetch a single order by id. Poll this endpoint to learn the outcome of an asynchronous order.

Path parameters

Parameter	Type	Description
`order_id`	string	The order id returned when the order was created.

Response

{
  "data": {
    "order_id": "ord_9c2b7f0a",
    "status": "COMPLETED",
    "product": "TRON_ENERGY",
    "order_type": "RENTAL",
    "amount": 64400,
    "duration_minutes": 60,
    "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "customer_price": "2.093",
    "order_total": "2.093",
    "actual_consumed": "2.093",
    "currency": "TRX",
    "created_at": "2026-09-22T12:00:00.000Z",
    "completed_at": "2026-09-22T12:00:05.000Z",
    "failure_reason": null,
    "tx_info": {
      "delegate_tx_hash": "…",
      "reclaim_tx_hash": "…",
      "delegate_time": "…",
      "reclaim_time": "…",
      "resource_address": "T…"
    }
  },
  "request_id": "…"
}

status is one of PENDING, COMPLETED, FAILED, RECONCILIATION_REQUIRED.

Field	Type	Description
`order_total`	string	The total agreed at order time, in TRX (decimal string, not SUN). For a rental order this equals `customer_price`.
`actual_consumed`	string	The amount actually charged, in TRX. For a rental order this equals `customer_price`.
`customer_price`	string	The order price, in TRX (decimal string, not SUN; 1 TRX = 10^6 SUN).
`currency`	string	Always `TRX`.
`tx_info`	object \| null	Public on-chain delegation/reclaim detail. May be `null` while the order is in-flight.

The tx_info object contains only public, on-chain facts:

Field	Type	Description
`delegate_tx_hash`	string \| null	Delegation transaction hash.
`reclaim_tx_hash`	string \| null	Reclaim transaction hash.
`delegate_time`	string \| null	Delegation time (as reported by the chain).
`reclaim_time`	string \| null	Reclaim time (as reported by the chain).
`resource_address`	string \| null	The address that actually delegated the resource.

Errors

ORDER_NOT_FOUND — the order does not exist or is not yours.