Retrieve your organization's current account balance and paginated transaction history. Your balance consists of a usable cash balance available for orders.
/api/v1/balance
Returns the current usable cash balance and pending balance for your organization.
balance.read
availableBalanceavailableBalance.amountavailableBalance.currencyUSDpendingBalancependingBalance.amountpendingBalance.currencyUSD/api/v1/balance/charge
Submit an ACH wire transfer request to top up your organization's balance.
The request is recorded with PENDING status and reviewed by the Giftronaut team.
Balance is credited after wire transfer is confirmed.
Not available in sandbox. Production credentials only.
balance.write
amount100.00.companyNamephoneNumberbillingAddresscitystatecountryUSzipCodeein12-3456789companyWebsitefundingNoamount{ amount, currency }statusPENDING — balance is credited after wire is confirmedmessageestimatedProcessingTime1-3 business dayscreatedAt/api/v1/balance/charge/{fundingNo}
Withdraws (voids) a still-pending ACH top-up request — the same action as
"Void Funding Request" in the portal balance history. Only requests awaiting review can be
canceled; completed, rejected, or already-canceled requests return 409 FUNDING_NOT_CANCELABLE.
After cancel the request no longer counts toward pendingBalance, and the reserved
balance.ach_approved / balance.ach_rejected webhook events will not fire.
Not available in sandbox. Production credentials only.
balance.write
fundingNoPOST /balance/chargefundingNoamount{ amount, currency }statusCANCELEDcanceledAt/api/v1/balance/ledger
Returns a paginated, reverse-chronological list of balance transactions — charges, order deductions, refunds, and transfers.
balance.read
pagepageSizestartDate2024-01-01endDate2024-12-31CHARGEUSEREFUNDTRANSFERStart typing to search...
Select the APIs you want to integrate. A ready-to-use Markdown file with full API specs and a project context template will be generated and downloaded. Paste it into your AI assistant to get started instantly.