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

> List your invoices with optional filtering

## List Invoices

Returns a paginated list of your invoices.

### Query parameters

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

<ParamField query="status" type="string">
  Filter by status: `pending`, `paid`, `delegated`, `expired`, `failed`
</ParamField>

### Response

Returns a paginated object with `invoices` array and `total` count.

### Example

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

```json Response theme={null}
{
  "invoices": [
    {
      "invoice_id": 789,
      "payment_address": "TPaymentAddress...",
      "address": "TRecipientAddress...",
      "energy_amount": 65000,
      "duration_hours": 1,
      "price_trx": "2.75",
      "price_usdt": "0.64",
      "status": "delegated",
      "created_at": "2026-03-05T12:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pages": 1
}
```