> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.prolifi.io/endpoints/invoices/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.prolifi.io/_mcp/server.

# Invoices

Invoices are generated automatically by Prolifi's billing engine when a subscription billing cycle completes. You can also finalize or void invoices through the API.

## Endpoints

| Method | Path                      | Description                |
| ------ | ------------------------- | -------------------------- |
| `GET`  | `/invoices`               | List invoices (paginated)  |
| `GET`  | `/invoices/{id}`          | Get an invoice             |
| `POST` | `/invoices/{id}/finalize` | Finalize a pending invoice |
| `POST` | `/invoices/{id}/void`     | Void an invoice            |

## Key concepts

* **Invoice lifecycle**: Invoices progress through statuses — `pending` → `posted` → `paid` (or `void`).
* **Finalization**: Only `pending` invoices can be finalized. Finalizing transitions an invoice to `posted`, making it ready for payment collection.
* **Voiding**: Cancels an invoice. Already-voided invoices cannot be voided again.
* **Line items**: Each invoice contains line items that break down the charges (plan, add-ons, usage, etc.).
* **Filtering**: Use `customer_id`, `status`, or `subscription_id` query parameters to filter the list.

> List, retrieve, finalize, and void invoices


## API Docs

- Invoices [List invoices](https://docs.prolifi.io/endpoints/invoices/list-invoices.md)
- Invoices [Get an invoice](https://docs.prolifi.io/endpoints/invoices/get-invoice.md)
- Invoices [Finalize an invoice](https://docs.prolifi.io/endpoints/invoices/finalize-invoice.md)
- Invoices [Void an invoice](https://docs.prolifi.io/endpoints/invoices/void-invoice.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.prolifi.io/endpoints/invoices/openapi.json)
- [OpenAPI YAML](https://docs.prolifi.io/endpoints/invoices/openapi.yaml)