> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/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 Seller Account

`GET /api/v2/storefront/billing`

Returns your Seller Account'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.apostra.com/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 Seller Account remain
on consolidated billing (`agent`) and funds continue to accrue, but Apostra
cannot disburse them. Missing payout details do not block activation or silently
switch a booking to direct billing. Save details with [Set payout
details](/v2/storefront/billing/tasks/set-payout-details) before you need a
payout.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.