> ## 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.
# billingBills
> List new-system merchant bills, newest first, including balances and charges for accounting reconciliation.
**Required scopes:** [`invoices_read`](/docs/api-reference/v3/reference/scopes#scope-invoices_read)
## Arguments
Opaque cursor from the preceding page.
Bills to return, 1 to 100; defaults to 25.
## Returns
BillingBillConnection!} required>
A paginated list of BillingBill items.
[BillingBillEdge!]!} required>
The list of edges (each a node plus its pagination `cursor`).
Opaque cursor for this item; pass to `after`/`before` to page from here.
BillingBill!} required>
The item at this edge.
DateTime!} required>
Date shown as billed on the merchant invoice.
Money}>
Charge total valued in bill currency, excluding unstruck foreign charges.
Money!} required>
Current bill balance; positive means owed by the merchant.
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.
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.
[BillingBill!]!} required>
The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.
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).
PageInfo!} required>
Pagination metadata for the current page.
Cursor of the last edge in this page; pass to `after` to page forward.
Whether more items exist after this page (drives forward pagination with `first`/`after`).
Whether more items exist before this page (drives backward pagination with `last`/`before`).
Cursor of the first edge in this page; pass to `before` to page backward.
## Example
```graphql theme={null}
query {
billingBills(after: "...", first: 10) {
nodes {
billedAt
currency
dueAt
id
periodEnd
periodStart
status
type
# ...
}
pageInfo { hasNextPage endCursor }
}
}
```
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.