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

# List Wallets

List all wallets, optionally filtered by account or status.

<ParamField query="accountId" type="string">
  Filter wallets by account ID.
</ParamField>

<ParamField query="active" type="boolean">
  Filter by active status. Returns only active wallets if `true`, only inactive if `false`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.alguna.io/wallets?accountId=acc_abc123&active=true" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const wallets = await alguna.wallets.list({
    accountId: 'acc_abc123',
    active: true
  });
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "items": [
      {
        "id": "wal_def456",
        "accountId": "acc_abc123",
        "name": "Prepaid Credits",
        "currency": "USD",
        "currentBalance": "500.00",
        "active": true,
        "productIds": ["prod_xyz789"],
        "createdAt": "2024-01-20T10:00:00Z",
        "updatedAt": "2024-01-20T12:00:00Z"
      },
      {
        "id": "wal_ghi789",
        "accountId": "acc_abc123",
        "name": "Promotional Credits",
        "currency": "USD",
        "currentBalance": "100.00",
        "active": true,
        "productIds": [],
        "createdAt": "2024-01-15T08:00:00Z",
        "updatedAt": "2024-01-18T14:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>

<ResponseField name="items" type="array">
  Array of wallet objects.
</ResponseField>