GET /api/v2/storefront/billing/accounts
Returns billing status for each managed account of an organization —
whether the account inherits billing from the organization or has its own payout
setup, and whether payout details are on file. Call this from the organization
to audit which accounts still need bank details entered before their
media buys can use Interchange-cleared settlement.
Request
Parameters
This endpoint takes no parameters.Response
inherited: true means the account uses the
organization’s billing and onboardingStatus is none. When inherited is false,
the account has its own billing configuration and onboardingStatus is its payout
setup status — pending, complete (payout details on file), or restricted.
To fill a gap, the organization calls
Set payout details with
?targetCustomerId=<accountId>.
Errors
400 VALIDATION_ERROR— the caller is not an organization or has no managed accounts.
Related
Billing tasks
All billing operations
Get billing config
Read one account’s configuration
Set payout details
Save details on behalf of an account
Billing overview
How payouts work and why bank details are needed