Get ad account funding details

Reads the organization's funding details for adding funds to its ad accounts by bank transfer or stablecoin: the bank account to pay and its holder, the USDC and USDT deposit address per network, the ad account deposits go to, the latest deposits with what each added, and what each shared ad account has left to spend.

Tool name: get-ad-account-funding.

When to use

Use when the user wants to add funds by bank transfer or crypto, asks whether a transfer arrived, or asks how much an ad account has left to spend. A card payment goes through add-ad-account-funds instead.

Access

Property	Value
Required scope	`read`
Publishes	No
Read-only	Yes
Destructive	No
Idempotent	Yes
Open world	Yes

Input

This tool takes no input.

Output

Field	Type	Required	Description
`bank`	`object \| null`	Yes	Where to send a US bank transfer in USD: ACH, wire or RTP. Null while bank transfers are not offered.
`crypto`	`object[]`	Yes	One deposit address per stablecoin and network. Only that coin on that network may be sent to it: another coin or network can be lost for good. Empty while crypto is not offered.
`target`	`object \| null`	Yes	The ad account deposits go to. Null until one is chosen, when the organization has more than one.
`targets`	`object[]`	Yes	The ad accounts deposits can go to: the organization's shared USD ad accounts.
`minimumCents`	`integer`	Yes	The smallest budget, in USD cents, a deposit is added for without Koast checking it first.
`onHold`	`boolean`	Yes	True while deposits and payments for funds are on hold for the organization. The user contacts Koast support.
`deposits`	`object[]`	Yes	The latest deposits, newest first.
`balances`	`object[]`	Yes	What each of the organization's shared ad accounts has left to spend.

REST equivalent

GET /v1/ad-account-funding, Get ad account funding details. CLI: koast get-ad-account-funding.