Navigation

Fetch Wallets

Retrieve all wallets in your organization

POST /public/account/fetchWallets

Returns all wallets belonging to the organization — including both organization-level wallets and individual member wallets. Each wallet includes its ID, label, type (organization or member), owning member ID, balance, and last update timestamp in UTC.

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

Request Body

Content-Type: application/json

Example

json 
{
    "org_id": "YOUR_ORG_ID",
    "api_key": "YOUR_API_KEY"
}

Code Samples

bash 
curl -X POST https://app.zyntrohq.com/public/account/fetchWallets \
  -H "Content-Type: application/json" \
  -d '{"api_key": "YOUR_API_KEY", "org_id": "YOUR_ORG_ID"}'

Response

200 Wallets retrieved
json 
{
    "data": [
        {
            "wallet_id": "e8932389-bca5-4e6e-b9f1-bf46e16e8435",
            "wallet_type": "organization",
            "wallet_label": "Main Wallet",
            "wallet_balance": "500.00",
            "wallet_memberid": null,
            "wallet_last_update": "2026-04-02T18:30:00+00:00"
        },
        {
            "wallet_id": "f9a43490-dcb6-5f7f-c0g2-cg57f27f9546",
            "wallet_type": "member",
            "wallet_label": "Jane's Wallet",
            "wallet_balance": "75.25",
            "wallet_memberid": "f2470c7f-60b1-4491-b117-8ba0e3e2a53b",
            "wallet_last_update": "2026-04-01T12:00:00+00:00"
        }
    ],
    "status": "success"
}
200 Error
json 
{
    "data": [
        "No matching wallet found"
    ],
    "status": "error"
}
Info: Wallets can belong to the organization or to individual members. The `wallet_type` field indicates ownership: `organization` for org-level wallets, `member` for individual member wallets. The `wallet_memberid` field shows which member owns member-type wallets.

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.
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.
NO_WALLETS No matching wallet found
No wallets exist for this organization. 		Contact support — wallets are typically provisioned during account setup.
3 min read Updated Apr 2, 2026

Was this article helpful?

NotebookLM Overviews