Viewing Assets & Activity

Planbok provides organizational-level aggregation endpoints that allow you to monitor balances and transaction history across all wallets and wallet sets in your organization.

1. Checking Balances

You can fetch the current balance of fungible and native assets for a specific wallet or a group of wallets.

Endpoint: GET /v2/wallets/{id}/balances
Headers:

• PLANBOK-X-API-KEY: <your_api_key>

Fetching for a Wallet Set

If you want to see the total assets held by a logical group (e.g., "Account #1" across all chains):

Endpoint: GET /v2/wallet-sets/{id}/balances

2. Listing Transactions

Retrieve the history of all signing and transfer actions initiated by your organization.

Endpoint: GET /v2/organization/transactions

Query Parameters:

• status: Filter by confirmed, broadcast, failed, or cancelled.
• walletIds: Comma-separated list of wallet IDs to filter history.
• blockchain: Filter by a specific chain (e.g., ETH-SEPOLIA).
• operation: Filter by action type (e.g., transfer, contract-execution).
• refId: Filter by the Wallet's reference ID.
• limit / page: Standard pagination.

Detailed Transaction View

To see the full payload, signatures, and blockchain confirmation data for a single event:

Endpoint: GET /v2/organization/transactions/{id}

3. Real-Time Updates via Webhooks

While polling the API is useful, we recommend using Webhooks for production systems. Webhooks allow you to receive push notifications for:

• transaction.confirmed: Triggered when a transfer or contract call is successfully mined.
• transaction.failed: Triggered if a transaction is rejected or reverted by the network.
• transaction.broadcast: Triggered when the transaction has been submitted to the blockchain mempool.

Conclusion

You have now covered the full operational lifecycle of Organizational Custody Wallets. From initial registration to daily asset management, your organization has total, API-driven control over its digital assets.