Invoices

Every confirmed payment issues an invoice automatically: seller and buyer details, tax breakdown, and (for stablecoin payments) the exchange rate used to convert to fiat. The seller of record on every invoice is Aristokrates OÜ (Estonia), AgentaOS’s Merchant of Record entity, unless the payment settled to your own on-chain wallet, in which case you are the seller.

Amounts on the Invoice object (amount, fiatAmount, taxAmount) are decimal currency units, same as everywhere else in this API. 19.99 means €19.99, not cents.

Create and send an invoice

Bill a customer directly from the dashboard, no code required. Open Finance → Invoices and click New invoice. Add your line items, fill in the customer’s details and country (we calculate the right VAT), set your payment terms, and send. Your customer pays on the same secure checkout, by card, Apple Pay, or Google Pay.

AgentaOS invoice builder showing seller and buyer details, a line item, and the VAT breakdown — The invoice builder. AgentaOS is the merchant of record, so VAT is calculated from the customer's country.

Every invoice you send, and every invoice issued automatically when a payment clears, is available over the API below.

List invoices

Paginated: every list call returns { items, total, hasMore }. Filter by date range and status.

SDK
CLI
cURL

const page = await agentaos.invoices.list({
  from: '2026-03-01',
  to: '2026-03-31',
  status: 'issued',   // 'all' | 'issued' | 'paid' | 'voided'
  limit: 50,
});

agenta invoices list --limit 50

curl "https://api.agentaos.ai/api/v1/gateway/invoices?from=2026-03-01&to=2026-03-31&status=issued" \
  -H "x-api-key: sk_live_..."

Retrieve an invoice

SDK
cURL

const invoice = await agentaos.invoices.retrieve('invoice-uuid');

curl https://api.agentaos.ai/api/v1/gateway/invoices/invoice-uuid \
  -H "x-api-key: sk_live_..."

Void an invoice

Voiding marks the accounting record as void. It never touches the payment itself: the buyer already paid, and nothing is refunded. Use it to correct a bookkeeping mistake, not to reverse a charge.

SDK
cURL

await agentaos.invoices.void('invoice-uuid');

curl -X POST https://api.agentaos.ai/api/v1/gateway/invoices/invoice-uuid/void \
  -H "x-api-key: sk_live_..."

Voiding is irreversible. The invoice stays void forever; there’s no “un-void.”

Download the invoice PDF

SDK
cURL

import { writeFileSync } from 'fs';

const pdf = await agentaos.invoices.downloadPdf('invoice-uuid');
writeFileSync('invoice.pdf', pdf);

curl https://api.agentaos.ai/api/v1/gateway/invoices/invoice-uuid/pdf \
  -H "x-api-key: sk_live_..." \
  -o invoice.pdf

The PDF includes merchant and buyer details, the amount (plus the fiat equivalent and exchange rate for stablecoin payments), a tax breakdown (subtotal, tax, total), and a link to the on-chain transaction where relevant.

Download a statement

A monthly-statement-style PDF covering a date range: opening/closing balance, every transaction in the ledger, and a VAT summary grouped by rate.

SDK
cURL

const statement = await agentaos.invoices.downloadStatement({
  from: '2026-03-01',
  to: '2026-03-31',
});
writeFileSync('march-statement.pdf', statement);

curl "https://api.agentaos.ai/api/v1/gateway/invoices/statement?from=2026-03-01&to=2026-03-31" \
  -H "x-api-key: sk_live_..." \
  -o statement.pdf

Export CSV

A 23-column CSV built for accounting software: date, direction, invoice number, description, crypto amount, token, and token address, chain, exchange rate (and source and timestamp), fiat amount and currency, tax name/rate/amount, total_eur (always in EUR), buyer name/company/country/VAT, transaction hash, and status.

SDK
cURL

const csv = await agentaos.invoices.exportCsv({
  from: '2026-03-01',
  to: '2026-03-31',
  status: 'issued',
});
writeFileSync('invoices.csv', csv);

curl "https://api.agentaos.ai/api/v1/gateway/invoices/export?from=2026-03-01&to=2026-03-31" \
  -H "x-api-key: sk_live_..." \
  -o invoices.csv

Response

string

Invoice UUID.

string

Human-readable, e.g. INV-2026-0001.

number

Amount in the payment token/currency.

string

Currency or token code.

number | null

EUR/USD equivalent, for stablecoin payments.

string | null

EUR or USD.

number | null

Rate applied at settlement time.

string | null

Where the rate came from.

number | null

Applied tax rate, e.g. 19 for 19%.

number | null

Tax amount in currency units.

string | null

e.g. DE VAT.

boolean | null

Whether amount already includes tax.

string | null

Seller name on the invoice.

string | null

Buyer email.

string | null

Buyer name.

string | null

Buyer company.

string | null

ISO 3166-1 alpha-2.

string | null

Buyer VAT number, if provided.

string

issued, paid, or voided.

string

ISO 8601.

string | null

ISO 8601, if voided.

Next steps

Receipts

Every paid invoice also gets a receipt, emailed automatically.

Customers

The buyer behind each invoice.

Tax

How destination VAT is calculated and remitted.

Webhooks

Know the moment a new invoice is issued.

Getting Started

Build with AI agents

Sell

Merchant of Record

Webhooks

For customers

Experimental

Create and send an invoice

List invoices

Retrieve an invoice

Void an invoice

Download the invoice PDF

Download a statement

Export CSV

Response

Next steps

Receipts

Customers

Tax

Webhooks

​Create and send an invoice

​List invoices

​Retrieve an invoice

​Void an invoice

​Download the invoice PDF

​Download a statement

​Export CSV

​Response

​Next steps

Receipts

Customers

Tax

Webhooks

Create and send an invoice

List invoices

Retrieve an invoice

Void an invoice

Download the invoice PDF

Download a statement

Export CSV

Response

Next steps