Skip to main content
GET /api/v2/storefront/billing/accounts Returns billing status for each managed child account of a parent customer — whether the child inherits billing from the parent or has its own Stripe account, and that account’s onboarding status. Call this from the parent customer to audit which children still need billing set up.

​
Request

curl "https://api.interchange.io/api/v2/storefront/billing/accounts" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

This endpoint takes no parameters.

​
Response

{
  "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 child account. inherited: true means the child uses the parent’s billing and onboardingStatus is none. When inherited is false, the child has its own Stripe account and onboardingStatus is one of pending, complete, or restricted.

​
Errors

  • 400 VALIDATION_ERROR — the caller is not a parent customer or has no managed child accounts.
See Errors for the full error contract.

Billing tasks

All billing operations

Get billing config

Read one account’s configuration

Provision Stripe Connect

Provision on behalf of a child

Billing overview

Stripe Connect concepts