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

# List Agents

> List all agents globally across all wallets.

## Request Headers

<ParamField header="x-api-key" type="string" required>
  Your live or test API key.
</ParamField>

## Query Parameters

<ParamField query="wallet_id" type="string">
  Filter agents attached to a specific wallet.
</ParamField>

## Response

<Note>
  All amounts and balances in this endpoint are represented in **kobo** (e.g., `500000` = ₦5,000.00). Ensure you do not send or expect Naira values.
</Note>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "items": [
        {
          "id": "a9b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
          "wallet_id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
          "developer_id": "d7b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
          "name": "Auto-Sweep on Full Payment",
          "trigger": "BALANCE_ABOVE",
          "threshold": 10000000,
          "action": "SWEEP",
          "destination_wallet_id": "f5c3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
          "sweep_amount": null,
          "is_active": true,
          "trigger_count": 4,
          "last_triggered_at": "2026-07-01T14:00:00Z",
          "created_at": "2026-07-01T13:00:00Z"
        }
      ],
      "total": 1,
      "page": 1,
      "limit": 20
    }
  }
  ```
</ResponseExample>