Get a wallet

Returns a single wallet for the association resolved from the token. Balances are embedded in the response. A wallet that exists but belongs to a different association 404s identically to one that does not exist.

GET /wallets/{walletId}

Get a wallet

cURL

curl --request GET \
  --url https://api.zeam.money/gw/v1/wallets/{walletId} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-zeam-auth: <api-key>'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "publicKey": "<string>",
  "walletName": "<string>",
  "accountNumber": "<string>",
  "networkName": "<string>",
  "hasMultipleSigners": true,
  "ownAccount": true,
  "status": "Pending",
  "balances": [
    {
      "assetCode": "USDZ",
      "balance": "1250.0000000"
    }
  ]
}

Authorizations

Authorization · string · header · required

Access token issued by POST /v1/auth/token.

x-zeam-auth · string · header · required

Application secret (the apiKey issued at registration), required on every request.

Path Parameters

walletId · string<uuid> · required

Wallet identifier.

Response

200

application/json

The wallet.

id · string<uuid> · required

publicKey · string · required

Stellar public key (G...)

walletName · string

accountNumber · string

Zeam account number.

networkName · string

Platform network name.

hasMultipleSigners · boolean

ownAccount · boolean

Whether the wallet belongs to the association's own business (false = held on behalf of a third party).

status · enum<string>

Verification status. Only a Verified wallet may be transacted on; own-account wallets are Verified at creation, third-party wallets start Pending until their KYC review completes.

Available options: Pending, Verified, Rejected

balances · object[]

On-chain balances. Populated best-effort; may be empty if the Horizon lookup failed. Native XLM is excluded.

Show child attributes