# Invoices

The WarpStream API enables users to retrieve current and past invoices. The responses from this API can be used to monitor costs, and also analyze historical billing data.

The [/get\_pending\_invoice](https://docs.warpstream.com/warpstream/reference/api-reference/invoices/get-pending-invoice) endpoint retrieves the current billing period invoice, providing visibility into charges accrued so far in the billing cycle.

The [/get\_past\_invoice](https://docs.warpstream.com/warpstream/reference/api-reference/invoices/get-past-invoice) endpoint retrieves a single invoice from a previous billing period. The date passed in `"date_start"` does not need to be an exact match for the beginning of the billing cycle. If the date falls within a billing cycle for which an invoice exists, the API will return a response containing the invoice for the full billing period. For example, if the billing period is from April 1 through April 30, passing `"date_start": "2025-04-15"` will return the invoice for the period starting April 1.

Both endpoints group by Tenant ID, then Workspace ID, then Virtual Cluster ID, providing the ability to analyze line-item-level detail, or rollups aggregated by entity. Finally, account-level charges (such as support billing) and credit consumption are displayed at the top level of the schema.