Fetch Wallet
Retrieve a single wallet by ID
Returns a single wallet record by ID — including its label, current balance, and last update timestamp (converted to UTC with timezone offset).
Requires a valid `api_key` in the JSON request body
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
api_key |
body | string |
Yes | Your Zyntro API key |
org_id |
body | string |
Yes | Your organization UUID |
wallet_id |
body | string |
Yes | The UUID of the wallet to retrieve |
Request Body
Content-Type: application/json
Example
json
{
"org_id": "YOUR_ORG_ID",
"api_key": "YOUR_API_KEY",
"wallet_id": "e8932389-bca5-4e6e-b9f1-bf46e16e8435"
}Code Samples
bash
curl -X POST https://app.zyntrohq.com/public/account/fetchWallet \
-H "Content-Type: application/json" \
-d '{"api_key": "YOUR_API_KEY", "org_id": "YOUR_ORG_ID", "wallet_id": "e8932389-bca5-4e6e-b9f1-bf46e16e8435"}'Response
200
Wallet retrieved
json
{
"data": {
"wallet_id": "e8932389-bca5-4e6e-b9f1-bf46e16e8435",
"wallet_label": "Main Wallet",
"wallet_balance": "142.50",
"wallet_last_update": "2026-04-02T18:30:00+00:00"
},
"status": "success"
}
200
Error
json
{
"data": [
"No matching wallet found"
],
"status": "error"
}
Info:
The `wallet_last_update` timestamp is converted to UTC with timezone offset (ISO 8601 format). The conversion is based on your organization's configured timezone.
Errors
| Code | Message | Resolution |
|---|---|---|
MISSING_API_KEY |
Missing service instance The api_key is missing. |
Include your API key. |
INVALID_API_KEY |
Invalid API Key No active user matches. |
Verify your key. |
MISSING_ORG |
Missing org ID The org_id is missing. |
Include your org ID. |
MISSING_WALLET |
Missing wallet ID The wallet_id is missing. |
Include the wallet UUID. Use Fetch Organization to get the default_wallet or Fetch Wallets to list all wallets. |
NOT_FOUND |
No matching wallet found No wallet with that ID exists in the organization. |
Verify the wallet_id belongs to your org. |
ORG_NOT_FOUND |
Organization not found The org does not belong to the user. |
Verify the org_id. |
ORG_INACTIVE |
Organization is not active The org is deactivated. |
Contact support. |
