---
title: "Get an agent wallet"
method: GET
path: "/v1/agent-wallets/{id}"
tags: ["Agent Wallets"]
---

# Get an agent wallet

`GET /v1/agent-wallets/{id}`

## Request

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

Fetch a specific agent wallet by ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

Agent wallet retrieved successfully

- AgentWalletDtoOutput
  - `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.

---

[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)