Get Order

GET

api

orders

{order_id}

Get Order

curl --request GET \
  --url https://api.example.com/api/v1/orders/{order_id}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/orders/{order_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/orders/{order_id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/orders/{order_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "activation_id": {},
  "activation_cost_trx": {}
}

Returns the current status and full details of an energy or bandwidth order.

Path parameters

number

required

Order ID — the id returned by Buy Energy or Buy Bandwidth.

Response

Returns the full order object including status, type, volume, price_trx, delegate_txid, and timestamps.

number | null

ID of the address activation this order paid for, or null when it paid for none.

string | null

What that activation cost, in TRX, on top of price_trx — this is the difference between the order price and the amount that left your balance.

null, not "0". Both fields are null when the order paid for no activation — either the recipient account already existed, or somebody else’s transaction created it. Note the difference from activation_cost_trx on the Buy Energy response, which is the string "0" in that case: comparing against "0" here would never match.

Order statuses

Status	Description
`pending`	Order received, delegation in progress
`filled`	Energy or bandwidth successfully delegated
`failed`	Delegation failed
`reclaimed`	Bandwidth returned after the rental period (bandwidth orders only)

Example

curl https://api.tronrental.com/v1/orders/12345 \
  -H "X-API-Key: your_api_key"

Response

{
  "id": 12345,
  "type": "energy",
  "target_address": "TRecipientAddress...",
  "volume": 65000,
  "duration": "1h",
  "price_trx": "1.79",
  "status": "filled",
  "delegate_txid": "a1b2c3d4e5f6...",
  "undelegate_txid": null,
  "reclaim_at": null,
  "source": "api",
  "activation_id": 8891,
  "activation_cost_trx": "1.20",
  "created_at": "2026-06-10T04:30:00Z"
}

Get Order

curl --request GET \
  --url https://api.example.com/api/v1/orders/{order_id}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/orders/{order_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/orders/{order_id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/orders/{order_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "activation_id": {},
  "activation_cost_trx": {}
}

Core API

Bandwidth Rentals

Auto Refill

Orders

Invoices

Smart Mode

Transfer Packages

Account

Webhooks

Get Order

Get Order

Path parameters

Response

Order statuses

Example

​Get Order

​Path parameters

​Response

​Order statuses

​Example

Get Order

Path parameters

Response

Order statuses

Example