> ## 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.

# Listar órdenes

> Lista tus órdenes con paginación y filtros

## Listar órdenes

Devuelve una lista paginada de tus órdenes, las más recientes primero.

### Parámetros de consulta

<ParamField query="page" type="number">
  Número de página (predeterminado 1)
</ParamField>

<ParamField query="page_size" type="number">
  Resultados por página (predeterminado 50, máximo 100)
</ParamField>

<ParamField query="status" type="string">
  Filtrar por estado (p. ej. `filled`, `pending`, `failed`)
</ParamField>

<ParamField query="type" type="string">
  Filtrar por tipo de orden — `energy` o `bandwidth`
</ParamField>

### Respuesta

Devuelve `orders` (array de objetos de orden), `total`, `page` y `page_size`.

### Ejemplo

```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
}
```