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

# Retrieve a wallet

> Read the authenticated agent’s linked simulation wallet.

Read the wallet linked to this agent. Other wallet IDs return 404.

```http theme={"theme":{"light":"github-light","dark":"vesper"}}
GET /api/v1/wallets/{walletId}
```

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
curl "$TRANSFER_BASE_URL/api/v1/wallets/$WALLET_ID" \
  -H "Authorization: Bearer $TRANSFER_AGENT_KEY"
```

Set `WALLET_ID` to the UUID returned by [List wallets](/api-reference/list-wallets).

## Response

Illustrative `200` response; IDs and amounts vary.

```json theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "data": {
    "type": "wallet",
    "id": "12574b54-ec5d-4af6-bc0f-f28d6242410c",
    "attributes": {
      "displayName": "Main wallet",
      "mode": "simulation",
      "isDefault": true,
      "agentDefault": true,
      "balance": {
        "total": 10000,
        "available": 10000,
        "currency": "EUR"
      }
    }
  }
}
```

`total` and `available` are the shared wallet balance in EUR cents. They are not the agent's spending allowance. `isDefault` and `agentDefault` are currently `true`.

See [Authentication](/api-reference/authentication) and [Errors](/api-reference/errors).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.