> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentaos.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Invoices
> Read tax-compliant invoice records with agentaos.invoices. PDFs, statements, CSV exports, and receipts.
Every confirmed payment, checkout or subscription renewal, issues a tax-compliant invoice: buyer details, applied tax rate and amount, exchange rate at settlement, and the merchant record AgentaOS billed as. `agentaos.invoices` reads those records and downloads their documents. There's no `create`, invoices are generated by AgentaOS when a payment confirms.
## `invoices.list(params?)`
```typescript theme={null}
const page = await agentaos.invoices.list({
from: '2026-03-01',
to: '2026-03-31',
status: 'issued',
limit: 50,
});
```
ISO 8601 date, inclusive lower bound.
ISO 8601 date, inclusive upper bound.
Max 5000.
Returns `PaginatedList`.
### Invoice fields
e.g. `'INV-2026-0001'`.
Currency units, in `paymentToken`.
The token the buyer paid with, e.g. `'EURC'`.
On-chain settlement transaction, if applicable.
EUR/USD equivalent, currency units.
`'EUR'` or `'USD'`.
Rate applied at settlement.
ISO 8601.
e.g. `19` for 19%.
Currency units.
e.g. `'DE VAT'`.
ISO 3166-1 alpha-2.
ISO 8601.
ISO 8601.
ISO 8601.
`amount`, `fiatAmount`, and `taxAmount` are plain decimal currency-unit numbers, not minor units. `19.99` means €19.99. See the [money model](/sdk/pay-overview#the-money-model).
## `invoices.retrieve(id)`
```typescript theme={null}
const invoice = await agentaos.invoices.retrieve('uuid');
```
Returns the full `Invoice` shape above for a single record.
## `invoices.void(id)`
```typescript theme={null}
await agentaos.invoices.void('uuid');
// → { success: true }
```
Sets `status` to `'voided'` and stamps `voidedAt`. The record is retained, `retrieve()` still returns it.
## Downloads
Every download method returns raw bytes, not a parsed JSON object. PDFs come back as `Buffer`, the CSV export comes back as `string`.
```typescript downloadPdf(id) theme={null}
const pdf = await agentaos.invoices.downloadPdf('uuid'); // Promise
fs.writeFileSync('invoice.pdf', pdf);
```
```typescript downloadStatement(params) theme={null}
// Monthly statement PDF: balance reconciliation, VAT summary, transaction ledger.
const statement = await agentaos.invoices.downloadStatement({
from: '2026-03-01',
to: '2026-03-31',
}); // Promise
fs.writeFileSync('march-statement.pdf', statement);
```
```typescript exportCsv(params?) theme={null}
const csv = await agentaos.invoices.exportCsv({
from: '2026-03-01',
to: '2026-03-31',
status: 'issued',
}); // Promise
fs.writeFileSync('invoices.csv', csv);
```
```typescript getReceipt(id) theme={null}
// Receipt PDF for a paid invoice. Falls back to the invoice PDF for
// invoices issued before receipts existed.
const receipt = await agentaos.invoices.getReceipt('uuid'); // Promise
fs.writeFileSync('receipt.pdf', receipt);
```
ISO 8601 date. Required for `downloadStatement`, optional for `exportCsv`.
ISO 8601 date. Required for `downloadStatement`, optional for `exportCsv`.
`exportCsv` only, optional.
`exportCsv`'s params are all optional: `{ from?: string; to?: string; status?: string }`. `downloadStatement` requires both `from` and `to`.
## `invoices.sendReceipt(id)`
Re-sends the receipt email to the buyer on file. Paid invoices only.
```typescript theme={null}
const result = await agentaos.invoices.sendReceipt('uuid');
console.log(result.sentTo); // buyer email the receipt was sent to
```
The email address the receipt was sent to.
## Next steps
`invoiceId`/`invoiceNumber` on a completed checkout point back here.
The buyers these invoices are billed to.
What a missing or already-actioned invoice ID throws.