---
title: "pols invoices"
description: "List your org's invoices, or download one as a PDF"
---

<!-- Generated by scripts/reference.mjs from the pols CLI's --help. Do not edit; run `npm run reference:sync`. -->

Without an invoice ID, list your org's invoices, newest first: one for each
paid top-up and subscription month. Drafts (DRAFT-... numbers, for test
payments) are not valid
invoices.

With an invoice ID (inv\_...), save its PDF, the invoice itself, as
pols-invoice-NUMBER.pdf in the current directory, or to `--output` ("-" for
stdout). The PDF is checked against the SHA-256 the invoice records.
Owners and admins only.

## Usage

```text
pols invoices [INVOICE] [flags]
```

## Examples

```sh
pols invoices
pols invoices inv_8f2k4m9q1x7c
pols invoices inv_8f2k4m9q1x7c -o invoice.pdf
```

## Flags

```text
-h, --help            help for invoices
-o, --output string   where to save the PDF; "-" for stdout (default pols-invoice-NUMBER.pdf)
```

The [global flags](/reference/cli/#global-flags) work with this command too.