Agent Wallets

List agent wallet intents

List policy intents across all agent wallets of an application, for human review (pending approvals and history). Narrow to one agent wallet with walletId; a wallet outside the application returns an empty page.

get/v1/agent-wallets/intents

Request

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

Query parameters

applicationIdstring uuid required

walletIdstring uuid

Example:550e8400-e29b-41d4-a716-446655440000

Only the intents of this agent wallet. A wallet outside the application returns an empty page.

statestring[]

currentPageinteger

pageSizeinteger

Response

Paginated list of intents with their owning wallet

totalinteger required

Total count of items matching the query

Example response

{
  "data": [
    {
      "hash": "0xa3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1",
      "kind": "usdc-transfer",
      "recipient": "0x4f6e8b129fa2c1b3d5e7a9c0b2d4f6e8a0c2e4f6",
      "resource": "api.shop.example.com/premium/report",
      "asset": "USDC",
      "amountNative": "12500000",
      "amountRef": "1180",
      "approvedAmountRef": "1180",
      "currentAmountRef": "1185",
      "state": "pending_human_approval",
      "decidedAt": "2026-06-17T14:32:00Z",
      "decidedBy": "jane.doe@example.com",
      "consumedAt": "2026-06-17T14:33:10Z",
      "expiresAt": "2026-06-17T14:33:00Z",
      "events": [
        {
          "kind": "human_approved",
          "amountRef": "1180",
          "at": "2026-06-17T14:32:00Z"
        }
      ],
      "wallet": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "label": "Shopping Agent",
        "network": "BaseSepolia"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.