---
title: "List agent wallets"
method: GET
path: "/v1/agent-wallets"
tags: ["Agent Wallets"]
---

# List agent wallets

`GET /v1/agent-wallets`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/agent-wallets`
- Auth: one of:
  - API key in header `X-Api-Key`
  - `bearer` (a scheme the document does not define)

List agent wallets for the current organization.

## Query parameters

- `filters` union[]
  - union
    - object
      - `operator` 'or' | 'and', required
      - `value` union[], required
        - union
          - object
            - `field` 'id', required
            - `operator` 'eq', required
            - `value` string, required
          - object
            - `field` 'createdAt', required
            - `operator` 'gt' | 'lt' | 'gte' | 'lte', required
            - `value` string, date-time, required
          - object
            - `field` 'updatedAt', required
            - `operator` 'gt' | 'lt' | 'gte' | 'lte', required
            - `value` string, date-time, required
          - object
            - `field` 'application.id', required
            - `operator` 'eq', required
            - `value` string, uuid, required
          - object
            - `field` 'label', required
            - `operator` 'contains', required
            - `value` string, required
          - object
            - `field` 'status', required
            - `operator` 'eq', required
            - `value` 'deploying' | 'ready' | 'active' | 'failed', required
    - object
      - `field` 'id', required
      - `operator` 'eq', required
      - `value` string, required
    - object
      - `field` 'createdAt', required
      - `operator` 'gt' | 'lt' | 'gte' | 'lte', required
      - `value` string, date-time, required
    - object
      - `field` 'updatedAt', required
      - `operator` 'gt' | 'lt' | 'gte' | 'lte', required
      - `value` string, date-time, required
    - object
      - `field` 'application.id', required
      - `operator` 'eq', required
      - `value` string, uuid, required
    - object
      - `field` 'label', required
      - `operator` 'contains', required
      - `value` string, required
    - object
      - `field` 'status', required
      - `operator` 'eq', required
      - `value` 'deploying' | 'ready' | 'active' | 'failed', required
- `sorters` object[]
  - `field` 'id' | 'createdAt' | 'updatedAt', required
  - `order` 'asc' | 'desc', required
- `currentPage` integer
- `pageSize` integer

## Response `200`

List of agent wallets retrieved successfully

- PaginatedAgentWalletDtoOutput
  - `data` object[], required: Array of items for the current page
    - `id` string, uuid, required: Entity UUID
    - `createdAt` string, date-time, required: Creation date (ISO 8601)
    - `updatedAt` string, date-time, required: Last update date (ISO 8601)
    - `label` string, required: Human-readable label for the wallet
    - `applicationId` string, uuid, required: Application this wallet belongs to
    - `address` string, required: On-chain address of the wallet
    - `status` 'deploying' | 'ready' | 'active' | 'failed', required: Current deployment status of the wallet
    - `network` 'EthereumAnvil' | 'BaseSepolia' | 'BaseMainnet' | 'XdcApothem' | 'XdcMainnet' | 'StellarQuickstart' | 'StellarTestnet' | 'StellarMainnet', required: Blockchain network of the wallet
    - `paymentRail` 'x402', required: Settlement rail the wallet uses to move funds.
    - `owner` object, nullable, required: Owner (responsable) accountable for the wallet spending. Null on wallets created before owners were introduced.
      - `id` string, uuid, required: User ID of the owner.
      - `name` string, required: Display name of the owner, as set on their user profile.
      - `email` string, email, required: Email address of the owner.
    - `whitelist` string[], required: Bare x402 domains this wallet may pay on — the domains of its wallet-scope destination allow rule. Empty when the wallet has no allow rule (a deny-list or no rule leaves it empty). Surfaced here so the admin list can render the domains without a second call.
    - `budget` object, nullable, required: Per-window (day/week/month) spending budget usage derived from the wallet's policy: each window carries its cap and the amount already consumed. Null when the wallet has no policy. Surfaced here so the admin can show budget consumption without extra calls.
      - `currency` string, required: ISO 4217 code the caps and spent amounts are denominated in.
      - `day` object, required: Calendar-day window (policy timezone).
        - `cap` string, nullable, required: Spending cap for the window, in reference-currency sub-units (e.g. EUR cents — divide by 100 for the major amount). Null = no cap.
        - `spent` string, required: Amount already consumed in the window, same sub-unit encoding as `cap`. Sum of the reference amounts of consumed policy intents since the window start. "0" when nothing was spent.
      - `week` object, required: Calendar-week window, Monday→Sunday (policy timezone).
        - `cap` string, nullable, required: Spending cap for the window, in reference-currency sub-units (e.g. EUR cents — divide by 100 for the major amount). Null = no cap.
        - `spent` string, required: Amount already consumed in the window, same sub-unit encoding as `cap`. Sum of the reference amounts of consumed policy intents since the window start. "0" when nothing was spent.
      - `month` object, required: Calendar-month window (policy timezone).
        - `cap` string, nullable, required: Spending cap for the window, in reference-currency sub-units (e.g. EUR cents — divide by 100 for the major amount). Null = no cap.
        - `spent` string, required: Amount already consumed in the window, same sub-unit encoding as `cap`. Sum of the reference amounts of consumed policy intents since the window start. "0" when nothing was spent.
    - `emergencyStop` boolean, required: True while the wallet is paused by its emergency stop: every payment is refused until it is resumed. False when the wallet has no policy.
  - `total` integer, required: Total count of items matching the query

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)