Invoices

Nimbus is prepaid, not net-terms, so an invoice is a receipt of paid-in and used balance rather than an amount owed. We produce a PDF invoice on the 1st of every month for the previous month's activity — plus an on-demand invoice for any single top-up if you need one for reimbursement.

How invoices are generated

Every balance transaction — top-up, usage debit, refund, adjustment — is written to the BalanceTx table with a timestamp, delta, method, running balance, and reference to the underlying request or payment. At 00:15 UTC on the 1st of each month, a cron job groups the prior month's rows by account, renders a PDF with our issuer details on top and the itemized ledger below, signs it, and emails it to the billing address on file. The PDF is also available in the dashboard forever.

Download from the dashboard

1. Go to /dashboard/billing/invoices.
2. Every past month is a row: invoice number, period, top-ups, spend, closing balance, PDF button.
3. Click PDF to download. The file is named Nimbus-INV-YYYY-MM-XXXXXX.pdf.
4. Click CSV to download the raw ledger for that period (importable into QuickBooks / Xero / Wave).

List invoices from the API

curl -sS https://llm.nimbusapi.net/v1/invoices \
  -H "Authorization: Bearer $NIMBUS_ACCOUNT_TOKEN"

Returns an array of invoice descriptors with id, period_start, period_end, total_topups_usd, total_usage_usd, pdf_url, and csv_url.

Download a single invoice

curl -sS https://llm.nimbusapi.net/v1/invoices/INV-2026-06-000123.pdf \
  -H "Authorization: Bearer $NIMBUS_ACCOUNT_TOKEN" \
  -o invoice-2026-06.pdf

Company info on the invoice

At /dashboard/billing/company fill in the fields that should appear in the "Bill To" block:

• Company / Bill-to name — e.g. Acme Robotics, Inc.
• Address — street, city, region, postal code, country
• VAT / GST / Tax ID — printed beneath the name
• Billing email — where the monthly PDF is sent (comma-separated for multiple recipients)
• Purchase order / reference — printed in the header for AP systems that require a PO number

Changes take effect on the next invoice. Past PDFs are static — email billing@nimbusapi.net if you need a historical invoice reissued with corrected company info.

Issuer info

Tax handling

• United States. We do not collect sales tax. Software-as-a-service is not taxable in Wyoming and we have no economic nexus in states that tax SaaS. If your state requires you to self-assess use tax, the invoice shows the pre-tax amount ready to accrue.
• European Union & United Kingdom. Reverse-charge applies. We invoice at 0% VAT with the note "Reverse charge — customer to account for VAT". Provide your VAT ID in Company info so it prints on the invoice.
• Rest of world. No withholding required on US-source digital services under most tax treaties. We provide a W-9 (US requesters) and W-8BEN-E (foreign requesters) on request.

Refunds on invoices

Refunds are recorded as a negative ledger entry in the month the refund clears and appear on that month's invoice as a separate line. See Top up for the 30-day refund policy.