> ## 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.
# billingCharges
> Page through the merchant's individual signed charge rows across all bills, optionally filtered by bill ID.
**Required scopes:** [`invoices_read`](/docs/api-reference/v3/reference/scopes#scope-invoices_read)
## Arguments
Opaque cursor from the preceding page.
Opaque cursor from the following page.
Optional numeric bill ID; omit for the full billing report.
Charges to return, 1 to 100; defaults to 25.
Charges to return before a cursor, 1 to 100.
## Returns
BillingBillChargeConnection!} required>
A paginated list of BillingBillCharge items.
[BillingBillChargeEdge!]!} 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.
BillingBillCharge!} required>
The item at this edge.
Money!} required>
Signed source charge amount; revenue-share deductions are separate negative rows.
Currency of the owning bill.
Money}>
Amount in bill currency at its frozen rate, or null if no strike exists.
Owning bill ID.
Related campaign ID.
Carrier fees in millionths of the charge currency.
DateTime!} required>
Charge creation time.
Related customer email.
Related customer first name.
Related customer last name.
Related fulfillment group ID.
Stable charge ID.
Stable source charge key.
Included units on this charge.
MMS messages counted by this charge.
Charge note in the Billing report.
Orders counted by this charge.
DateTime}>
Related order or fulfillment date used by the Billing CSV.
Related order ID.
Related order name.
Related order number.
Overage units on this charge.
DateTime!} required>
End of the period this charge covers.
DateTime!} required>
Start of the period this charge covers.
Redo product.
Money}>
Recovered revenue attributed to this charge.
Related return ID.
Decimal}>
Recorded merchant revenue-share rate, when present.
Charge ID reversed by this row.
Related shipment ID.
Related Shopify order ID.
SMS messages counted by this charge.
Charge subtype.
Charge type.
[BillingBillCharge!]!} required>
The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.
Money!} required>
Signed source charge amount; revenue-share deductions are separate negative rows.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Currency of the owning bill.
Money}>
Amount in bill currency at its frozen rate, or null if no strike exists.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Owning bill ID.
Related campaign ID.
Carrier fees in millionths of the charge currency.
DateTime!} required>
Charge creation time.
Related customer email.
Related customer first name.
Related customer last name.
Related fulfillment group ID.
Stable charge ID.
Stable source charge key.
Included units on this charge.
MMS messages counted by this charge.
Charge note in the Billing report.
Orders counted by this charge.
DateTime}>
Related order or fulfillment date used by the Billing CSV.
Related order ID.
Related order name.
Related order number.
Overage units on this charge.
DateTime!} required>
End of the period this charge covers.
DateTime!} required>
Start of the period this charge covers.
Redo product.
Money}>
Recovered revenue attributed to this charge.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Related return ID.
Decimal}>
Recorded merchant revenue-share rate, when present.
Charge ID reversed by this row.
Related shipment ID.
Related Shopify order ID.
SMS messages counted by this charge.
Charge subtype.
Charge type.
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 {
billingCharges(after: "...", before: "...", billId: "...", first: 10, last: 10) {
nodes {
billCurrency
billId
campaignId
carrierFeesMicros
createdAt
customerEmail
customerFirstName
customerLastName
# ...
}
pageInfo { hasNextPage endCursor }
}
}
```
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.