> ## 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.

# Get billing config

> Read the platform fee, additional fees, currency, net terms, and masked payout details for your storefront

`GET /api/v2/storefront/billing`

Returns your storefront's billing configuration: payout setup status, platform
fee percentage, any additional partner fees, payout currency, payment terms,
and the payout details on file (masked — the account number is never returned
after save). `billing` is `null` when no configuration exists yet. When billing
is inherited from your organization, `inherited` is `true`. Also available to
agents as the `get_billing_info` operation.

## Request

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

## Parameters

| Field              | Type   | Required | Notes                                                      |
| ------------------ | ------ | -------- | ---------------------------------------------------------- |
| `targetCustomerId` | number | No       | Query param. Organizations read a managed account's config |

## Response

```json theme={null}
{
  "billing": {
    "onboardingStatus": "complete",
    "platformFeePercent": 12.5,
    "fees": [
      { "name": "Ad serving", "description": "Third-party ad serving", "feePercent": 2 }
    ],
    "currency": "USD",
    "country": "US",
    "defaultNetDays": 30,
    "payoutDetails": {
      "beneficiaryName": "Meridian Media Group Inc.",
      "addressLine1": "500 Harbor Blvd",
      "addressLine2": null,
      "city": "Seattle",
      "region": "WA",
      "postalCode": "98101",
      "countryCode": "US",
      "accountNumberLast4": "6789",
      "bankIdentifierType": "FEDWIRE_ABA",
      "bankIdentifierValue": "021000021",
      "completedAt": "2026-07-01T09:30:00Z"
    },
    "inherited": false,
    "createdAt": "2026-04-25T12:00:00Z",
    "updatedAt": "2026-05-01T09:30:00Z"
  }
}
```

| Field                | Type           | Notes                                                                                |
| -------------------- | -------------- | ------------------------------------------------------------------------------------ |
| `onboardingStatus`   | enum           | Payout setup status: `pending`, `complete` (payout details on file), or `restricted` |
| `platformFeePercent` | number \| null | Platform fee percentage                                                              |
| `fees`               | array \| null  | Additional partner fees (`name`, `description`, `feePercent`)                        |
| `currency`           | string \| null | Payout currency (ISO 4217)                                                           |
| `country`            | string \| null | ISO 3166-1 alpha-2 country used for billing                                          |
| `defaultNetDays`     | number \| null | Payment terms in days                                                                |
| `payoutDetails`      | object \| null | Masked bank details on file — see below. `null` until saved                          |
| `inherited`          | boolean        | Whether this config is inherited from the organization                               |

`payoutDetails` carries `beneficiaryName`, the beneficiary address fields,
`accountNumberLast4` (the only part of the account number ever returned),
`bankIdentifierType` + `bankIdentifierValue`, and `completedAt`. While
`payoutDetails` is `null`, media buys against your storefront cannot use
Interchange-cleared (`agent`) settlement. A normal storefront is blocked from
activation rather than silently switching to seller-cleared — save details with
[Set payout details](/v2/storefront/billing/tasks/set-payout-details).

## Errors

* `400 VALIDATION_ERROR` — malformed request or invalid `targetCustomerId`.

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="Set payout details" href="/v2/storefront/billing/tasks/set-payout-details" icon="building-columns">
    Save the bank account Interchange pays into
  </Card>

  <Card title="Update billing config" href="/v2/storefront/billing/tasks/update-billing-config" icon="sliders">
    Change fees, currency, net days (admin)
  </Card>

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