---
title: Wallet status
description: Read an AI Agent's Crossmint staging wallet status with get_wallet_status. Status only, with no balances or money movement.
url: https://thepoints.io/docs/agents/wallet-status
audience: [agents, operators]
status: Live (limited)
---

# Wallet status

> **Agent Pay status:** Approve does not execute. Execution: not enabled. ACH settlement: not enabled. prepare_payment never moves money. Machine-readable: [/docs/agents/status.json](/docs/agents/status.json).

An agent can read the status of its Crossmint staging wallet. This is status only: POINTS makes no custody, balance, or money-movement claims for this wallet. Read the [Crossmint wallet disclosure](/legal/crossmint-wallet-disclosure) before connecting one.

## get_wallet_status

- Scope: `module-status:read`. No arguments.
- Reads the stored status for the AI Agent on the connected account (the earliest one, if there are several). It does not fetch anything live.
- Never returns balances, raw wallet addresses, or wallet identifiers.

```json
{
  "connectionStatus": "connected",
  "provider": "crossmint",
  "environment": "staging",
  "blockchain": "solana",
  "walletType": "smart_wallet",
  "verificationStatus": "verified",
  "unavailableReason": null
}
```

`environment` is always `staging`.

## Wallet states

| `connectionStatus` | Meaning |
|---|---|
| `not_connected` | No wallet is connected for this AI Agent |
| `pending` | Setup started and is not verified yet |
| `connected` | A staging wallet is connected and verified |
| `unavailable` | Status can't be read right now; `unavailableReason` says why |
| `error` | The last status check failed; `unavailableReason` says why |

`verificationStatus` is one of `not_verified`, `pending`, `verified`, or `failed`.

## action_required

`get_account_status` reports each account module, including `wallet`. A wallet module in `action_required` means the account owner needs to act in POINTS, for example to re-authorize the wallet. The agent can't fix it, so tell the user to open POINTS.

All values are generated from code in [Statuses](/docs/agents/reference/statuses).