> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Orders

> List your orders with pagination and filters

## List Orders

Returns a paginated list of your orders, newest first.

### Query parameters

<ParamField query="page" type="number">
  Page number (default 1)
</ParamField>

<ParamField query="page_size" type="number">
  Results per page (default 50, max 100)
</ParamField>

<ParamField query="status" type="string">
  Filter by status (e.g. `filled`, `pending`, `failed`)
</ParamField>

<ParamField query="type" type="string">
  Filter by order type — `energy` or `bandwidth`
</ParamField>

### Response

Returns `orders` (array of order objects), `total`, `page`, and `page_size`.

### Example

```bash theme={null}
curl "https://api.tronrental.com/v1/orders?type=energy&status=filled&page=1" \
  -H "X-API-Key: your_api_key"
```

```json Response theme={null}
{
  "orders": [
    {
      "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",
      "created_at": "2026-06-10T04:30:00Z"
    }
  ],
  "total": 42,
  "page": 1,
  "page_size": 50
}
```