> For the complete documentation index, see [llms.txt](https://docs.helodata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helodata.com/account-and-billing/invoices.md).

# Invoices

Every paid event — order, subscription renewal, top-up — produces an invoice. Find them under **Billing → Invoices**.

## What an invoice contains

```
helodata Inc.
Bill to:  Acme Inc., 123 Main St, San Francisco, CA 94103, USA
Tax ID:   US-EIN-12-3456789

Invoice:  INV-2026-05-001234
Date:     2026-05-28
Due:      2026-05-28  (paid)

Line items:
─────────────────────────────────────────────────────
1. Residential Pro plan — May 2026          $1,500.00
2. Top-up — auto, threshold $50                $200.00
3. ISP batch bat_01HX — 20 IPs × 1 month      $120.00
─────────────────────────────────────────────────────
Subtotal:                                    $1,820.00
Tax (CA 8.5%):                                 $154.70
─────────────────────────────────────────────────────
Total:                                       $1,974.70  USD
```

## Download

* **PDF** — for filing, accounting integrations
* **CSV** — for line-item analysis
* **JSON** — for programmatic processing

All three from **Billing → Invoices → {invoice} → Download**, or via API:

```bash
curl -H "Authorization: Bearer API_KEY" \
     "https://api.helodata.com/v1/invoices/inv_01HX/pdf" \
     -o invoice.pdf
```

## Listing

```bash
curl -H "Authorization: Bearer API_KEY" \
     "https://api.helodata.com/v1/invoices?from=2026-01-01&to=2026-05-31"
```

Filter by period or status (`paid`, `due`, `failed`).

## Tax

We apply tax based on:

* **US** — by ship-to state, where helodata has nexus (currently CA, NY, WA)
* **EU** — VAT at the rate of your billing country; if you supply a valid VAT ID, we reverse-charge (no VAT on invoice)
* **UK** — VAT 20%; reverse-charge with a valid VAT number
* **Canada** — GST/HST per province
* **Everywhere else** — no tax at source; you may owe local taxes

Update your **Tax ID** under **Billing → Address & tax** so it appears on invoices.

## Currency conversion

If your default currency is EUR or GBP but your card was charged in USD, the conversion rate appears on the invoice with the date applied. Your bank may apply a separate FX fee — that's between you and the bank.

## Custom invoice formatting

Enterprise plans can request:

* Custom logo on invoices
* A different "Bill to" entity (e.g. parent company vs subsidiary)
* Net 30 / Net 60 payment terms (instead of pay-on-issue)
* PO numbers on every invoice
* Multi-entity rollups (one master invoice per quarter)

Email **<billing@helodata.com>**.

## Disputes

If an invoice looks wrong:

1. Open it from **Billing → Invoices**.
2. Click **Dispute**.
3. Pick a reason and describe what's wrong.
4. Our billing team responds within 2 business days. If your dispute is valid, we issue a credit note that offsets the next invoice.

## Common pitfalls

* **VAT charged when you have a VAT ID** — your VAT ID wasn't validated. Check **Billing → Address & tax** for the green checkmark; otherwise re-enter or contact <billing@helodata.com>.
* **Tax appears on a US invoice but you're not in those states** — check your shipping/billing state in **Address & tax**.
* **Old invoices missing** — invoices are retained for 7 years; export periodically for your own retention if you need longer.