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

# BillingBill

> A new-system merchant bill with balance and charge summary.

**Required scopes:** [`invoices_read`](/docs/api-reference/v3/reference/scopes#scope-invoices_read)

<ResponseField name="billedAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
  Date shown as billed on the merchant invoice.
</ResponseField>

<ResponseField name="chargeTotal" type={<a href="/docs/api-reference/v3/reference/common/money">Money</a>}>
  Charge total valued in bill currency, excluding unstruck foreign charges.

  <Expandable title="fields" lazyRender>
    <ResponseField name="amount" type={<a href="/docs/api-reference/v3/reference/common/decimal">Decimal!</a>} required>
      The exact amount as a decimal string (e.g. "19.99").
    </ResponseField>

    <ResponseField name="currency" type="String!" required>
      ISO 4217 currency code (e.g. USD).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="closingBalance" type={<a href="/docs/api-reference/v3/reference/common/money">Money!</a>} required>
  Current bill balance; positive means owed by the merchant.

  <Expandable title="fields" lazyRender>
    <ResponseField name="amount" type={<a href="/docs/api-reference/v3/reference/common/decimal">Decimal!</a>} required>
      The exact amount as a decimal string (e.g. "19.99").
    </ResponseField>

    <ResponseField name="currency" type="String!" required>
      ISO 4217 currency code (e.g. USD).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="currency" type="String!" required>
  Bill settlement currency.
</ResponseField>

<ResponseField name="dueAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime</a>}>
  Payment due date, when assigned.
</ResponseField>

<ResponseField name="id" type="String!" required>
  Stable numeric bill ID.
</ResponseField>

<ResponseField name="openingBalance" type={<a href="/docs/api-reference/v3/reference/common/money">Money!</a>} required>
  Balance carried into this bill; positive means owed by the merchant.

  <Expandable title="fields" lazyRender>
    <ResponseField name="amount" type={<a href="/docs/api-reference/v3/reference/common/decimal">Decimal!</a>} required>
      The exact amount as a decimal string (e.g. "19.99").
    </ResponseField>

    <ResponseField name="currency" type="String!" required>
      ISO 4217 currency code (e.g. USD).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="periodEnd" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
  End of the billing period.
</ResponseField>

<ResponseField name="periodStart" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
  Start of the billing period.
</ResponseField>

<ResponseField name="status" type={<a href="/docs/api-reference/v3/reference/billing/billing-bill-status">BillingBillStatus!</a>} required>
  Stored bill lifecycle status.
</ResponseField>

<ResponseField name="type" type={<a href="/docs/api-reference/v3/reference/billing/billing-bill-type">BillingBillType!</a>} required>
  Bill type, such as ReturnShipping or Software.
</ResponseField>

<ResponseField name="unstruckForeign" type={<a href="/docs/api-reference/v3/reference/common/money">[Money!]!</a>} required>
  Foreign charges without a frozen bill-currency strike, grouped by currency.

  <Expandable title="fields" lazyRender>
    <ResponseField name="amount" type={<a href="/docs/api-reference/v3/reference/common/decimal">Decimal!</a>} required>
      The exact amount as a decimal string (e.g. "19.99").
    </ResponseField>

    <ResponseField name="currency" type="String!" required>
      ISO 4217 currency code (e.g. USD).
    </ResponseField>
  </Expandable>
</ResponseField>


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