> ## 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
> Get one new-system bill with invoice lines and revenue share. Missing and other-store IDs return null.
**Required scopes:** [`invoices_read`](/docs/api-reference/v3/reference/scopes#scope-invoices_read)
## Arguments
Numeric bill ID from billingBills.
## Returns
BillingBillDetail}>
A merchant bill with grouped line items and revenue split for reconciliation.
BillingBill!} required>
Bill identity, dates, status, and balance.
DateTime!} required>
Date shown as billed on the merchant invoice.
Money}>
Charge total valued in bill currency, excluding unstruck foreign charges.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Money!} required>
Current bill balance; positive means owed by the merchant.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Bill settlement currency.
DateTime}>
Payment due date, when assigned.
Stable numeric bill ID.
Money!} required>
Balance carried into this bill; positive means owed by the merchant.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
DateTime!} required>
End of the billing period.
DateTime!} required>
Start of the billing period.
BillingBillStatus!} required>
Stored bill lifecycle status.
BillingBillType!} required>
Bill type, such as ReturnShipping or Software.
[Money!]!} required>
Foreign charges without a frozen bill-currency strike, grouped by currency.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
[BillingBillLine!]!} required>
Aggregated invoice lines, including net-zero coverage lines retained for revenue reconciliation.
Money!} required>
Net charge in source currency, after any folded merchant share.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Money}>
Frozen bill-currency value, if available.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Merchant invoice section.
Number of source charge rows combined into this line.
Included usage count, if available.
Money}>
Merchant share already folded out of the net charge; do not subtract it again.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Stored invoice line name.
Recorded order count, if available.
Overage usage count, if available.
Associated Redo product.
Item quantity when stored on the invoice line.
Money}>
Recovered revenue associated with this line.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Decimal}>
Recorded merchant revenue-share rate, when applicable.
Specific charge subtype.
Charge type.
Money}>
Stored unit price when the line is quantity-based.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
False for a net-zero coverage line hidden in the invoice UI but retained here for gross revenue reconciliation.
BillingBillTotals!} required>
Invoice charges, credits, and coverage split.
Money!} required>
Positive billed charges after revenue-share folding.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Money!} required>
Credits and refunds on this invoice.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
True if any foreign amount lacks a frozen bill-currency value.
Money}>
Gross coverage paid by shoppers, if a revenue split was recorded.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Money}>
Coverage revenue retained by the merchant, not billed.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Money!} required>
Balance carried in from the previous period.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Money}>
Coverage revenue billed by Redo, net of coverage refunds.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Money!} required>
Charges plus credits plus opening balance; estimated when foreign charges have no frozen strike.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
## Example
```graphql theme={null}
query {
billingBill(id: "...")
}
```
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.