> For the complete documentation index, see [llms.txt](https://tron-energy-doc.crypto-chief.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tron-energy-doc.crypto-chief.com/api-reference/get-order.md).

# Order Status

## Order Status

Returns what became of an order. Free, and the right move after a timeout.

#### **Order Status**

<mark style="color:blue;">`GET`</mark> `https://energy.crypto-chief.com/v1/orders/{idempotency_key}`

**Headers**

| Name      | Value                                                     |
| --------- | --------------------------------------------------------- |
| Merchant  | Your project UUID                                         |
| Signature | [Signed request body](/getting-started/authentication.md) |

**Path**

| Name              | Type   | Description                                                                             |
| ----------------- | ------ | --------------------------------------------------------------------------------------- |
| `idempotency_key` | string | The key you sent when creating the order. URL-encode it if it contains anything exotic. |

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "id": 4471,
  "idempotency_key": "payout-8814",
  "status": "delivered",
  "receive_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "energy": 130285,
  "duration_sec": 3600,
  "price_sun": 5927968,
  "price_trx": "5.927968",
  "price_usd": "1.78",
  "credits": 17783904,
  "trx_usd": "0.30000000",
  "delivered_energy": 130285,
  "settled": true,
  "needs_attention": false,
  "created_at": "2026-08-30T11:42:07Z",
  "delivered_at": "2026-08-30T11:42:11Z"
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "ok": false,
  "error": "NOT_FOUND",
  "msg": "no order with that idempotency key"
}
```

{% endtab %}
{% endtabs %}

### Example

`sign()`, `canonical()`, `BASE`, `MERCHANT` and `API_KEY` are from [Authentication](/getting-started/authentication.md).

{% tabs %}
{% tab title="JavaScript" %}

```javascript
const res = await fetch(BASE + "/v1/orders/payout-8814", {
  headers: {
    Merchant: MERCHANT,
    Signature: GET_SIG,                  // md5(API_KEY) - see Authentication
  },
});
console.log(await res.json());
```

{% endtab %}

{% tab title="PHP" %}

```php
$ch = curl_init(BASE . "/v1/orders/payout-8814");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Merchant: ' . MERCHANT,
        'Signature: ' . $getSig,  // md5(API_KEY) - see Authentication
    ],
]);
print_r(json_decode(curl_exec($ch), true));
```

{% endtab %}

{% tab title="GO" %}

```go
req, _ := http.NewRequest("GET", base+"/v1/orders/payout-8814", nil)
req.Header.Set("Merchant", merchant)
req.Header.Set("Signature", getSig) // md5(apiKey) - see Authentication

res, err := http.DefaultClient.Do(req)
```

{% endtab %}

{% tab title="Python" %}

```python
res = requests.get(
    BASE + "/v1/orders/payout-8814",
    headers={
        "Merchant": MERCHANT,
        "Signature": GET_SIG,  # md5(API_KEY) - see Authentication
    },
)
print(res.json())
```

{% endtab %}

{% tab title="curl" %}

```bash
curl "$BASE/v1/orders/payout-8814" \
  -H "Merchant: $MERCHANT" \
  -H "Signature: $GET_SIG"
```

{% endtab %}
{% endtabs %}

### What it cost

`credits` is what was taken from your balance and `price_usd` is that figure in dollars, both recorded when the charge was made rather than converted now — so an order read a month later reports what you paid, not what it would cost today. `trx_usd` is the rate used.

All three are absent on an order nobody was charged for.

### Statuses

| `status`     | `settled` | `needs_attention` | Meaning                                                  |
| ------------ | --------- | ----------------- | -------------------------------------------------------- |
| `reserved`   | false     | false             | Claimed; a supplier is about to be called                |
| `placed`     | false     | false             | A supplier took it; delivery is being confirmed          |
| `delivered`  | true      | false             | Energy is on the address                                 |
| `refused`    | true      | false             | A supplier declined. Nothing bought, any charge refunded |
| `unresolved` | false     | **true**          | Outcome unknown. **Do not retry**                        |
| `refunded`   | true      | false             | Settled and returned to your credits                     |

### After a timeout

A `404` here means the request never reached us, so it is safe to send. Anything else means an order exists, and its `status` tells you what to do about it — see [Idempotency and Retries](/getting-started/idempotency.md).

### Only your own orders

The key is looked up within your project. An order belonging to somebody else answers `404`, identically to a key that does not exist, so this endpoint cannot be used to find out whether one does.