> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List billing accounts

> Read billing status across the managed accounts of an organization

`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

```bash theme={null}
curl "https://api.interchange.io/api/v2/storefront/billing/accounts" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

This endpoint takes no parameters.

## Response

```json theme={null}
{
  "accounts": [
    {
      "customerId": 9101,
      "name": "Acme Sports",
      "company": "Acme Media",
      "inherited": true,
      "onboardingStatus": "none"
    },
    {
      "customerId": 9102,
      "name": "Acme News",
      "company": "Acme Media",
      "inherited": false,
      "onboardingStatus": "complete"
    }
  ]
}
```

Each entry is one account. `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](/v2/storefront/billing/tasks/set-payout-details) with
`?targetCustomerId=<accountId>`.

## Errors

* `400 VALIDATION_ERROR` — the caller is not an organization or has no managed accounts.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Billing tasks" href="/v2/storefront/billing/tasks" icon="list-check">
    All billing operations
  </Card>

  <Card title="Get billing config" href="/v2/storefront/billing/tasks/get-billing-config" icon="gear">
    Read one account's configuration
  </Card>

  <Card title="Set payout details" href="/v2/storefront/billing/tasks/set-payout-details" icon="building-columns">
    Save details on behalf of an account
  </Card>

  <Card title="Billing overview" href="/v2/storefront/billing/overview" icon="credit-card">
    How payouts work and why bank details are needed
  </Card>
</CardGroup>