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 --request GET \
--url https://api.zeam.money/gw/v1/wallets/{walletId} \
--header 'Authorization: Bearer <token>' \
--header 'x-zeam-auth: <api-key>'{
"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"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Access token issued by POST /v1/auth/token.
Application secret (the apiKey issued at registration), required on every request.
Path Parameters
Wallet identifier.
Response
The wallet.
Stellar public key (G...)
Zeam account number.
Platform network name.
Whether the wallet belongs to the association's own business (false = held on behalf of a third party).
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 On-chain balances. Populated best-effort; null when the balance lookup failed. Native XLM is excluded.
Show child attributes
Show child attributes
Get a wallet
curl --request GET \
--url https://api.zeam.money/gw/v1/wallets/{walletId} \
--header 'Authorization: Bearer <token>' \
--header 'x-zeam-auth: <api-key>'{
"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"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "https://errors.zeam.app/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The 'amount' field must be a positive decimal.",
"instance": "/v1/quotes",
"requestId": "01J8Z6K3QW9F2",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}