# InvoiceKo

> InvoiceKo (https://invoiceko.com) is a free online invoice generator. Users fill in an invoice in the browser and download it as a PDF — no signup, no watermark, and invoice data never leaves the browser. It supports 25+ currencies, GST/VAT/sales tax, discounts, shipping, logos, and notes/terms.

## For LLMs and AI agents: creating a pre-filled invoice

You can create an invoice for a user by composing a **prefill link**. The user opens the link, reviews the invoice in the editor, and downloads the PDF. No API key or authentication is needed.

Format: `https://invoiceko.com/new?d=<payload>`

`<payload>` is base64url-encoded UTF-8 JSON (standard base64 is also accepted; padding optional). The homepage (`https://invoiceko.com/?d=...`) accepts the same parameter.

### Invoice JSON fields (all optional)

- `from` (object): the issuer — `name`, `address`, `email`, `phone`, `taxId` (strings)
- `to` (object): the client — same fields as `from`
- `number` (string): invoice number, e.g. "INV-0042"
- `issueDate` (string): "YYYY-MM-DD"
- `dueDate` (string): "YYYY-MM-DD"
- `currency` (string): ISO 4217 code — one of USD, EUR, GBP, INR, AUD, CAD, SGD, AED, JPY, CNY, CHF, SEK, NOK, DKK, NZD, ZAR, BRL, MXN, IDR, PHP, MYR, THB, SAR, NGN, KES
- `items` (array, max 100): `{ "description": string, "quantity": number, "rate": number }` — amount is computed as quantity × rate
- `taxLabel` (string): "Tax" | "GST" | "VAT" | "Sales Tax"
- `taxRate` (number): percent, 0–100, applied to the post-discount subtotal
- `discountType` (string): "percent" | "flat"
- `discountValue` (number)
- `shipping` (number): flat amount added after tax
- `notes` (string), `terms` (string)

Snake_case aliases are accepted (`tax_rate`, `issue_date`, `due_date`, `tax_id`, `discount_type`, `discount_value`, `tax_label`). Missing fields get sensible defaults (today's date, 14-day due date, USD, "Tax"). Logos cannot be set via link. JSON Schema: https://invoiceko.com/schema/invoice.json

### Example

Payload JSON:

{"from":{"name":"Acme Design Studio","email":"billing@acme.studio"},"to":{"name":"Globex Pvt Ltd","address":"42 MG Road, Bengaluru"},"number":"INV-0042","currency":"INR","items":[{"description":"Website redesign","quantity":1,"rate":90000},{"description":"Logo refresh","quantity":1,"rate":15000}],"taxLabel":"GST","taxRate":18,"notes":"Thank you for your business!"}

Resulting link:

https://invoiceko.com/new?d=eyJmcm9tIjp7Im5hbWUiOiJBY21lIERlc2lnbiBTdHVkaW8iLCJlbWFpbCI6ImJpbGxpbmdAYWNtZS5zdHVkaW8ifSwidG8iOnsibmFtZSI6Ikdsb2JleCBQdnQgTHRkIiwiYWRkcmVzcyI6IjQyIE1HIFJvYWQsIEJlbmdhbHVydSJ9LCJudW1iZXIiOiJJTlYtMDA0MiIsImN1cnJlbmN5IjoiSU5SIiwiaXRlbXMiOlt7ImRlc2NyaXB0aW9uIjoiV2Vic2l0ZSByZWRlc2lnbiIsInF1YW50aXR5IjoxLCJyYXRlIjo5MDAwMH0seyJkZXNjcmlwdGlvbiI6IkxvZ28gcmVmcmVzaCIsInF1YW50aXR5IjoxLCJyYXRlIjoxNTAwMH1dLCJ0YXhMYWJlbCI6IkdTVCIsInRheFJhdGUiOjE4LCJub3RlcyI6IlRoYW5rIHlvdSBmb3IgeW91ciBidXNpbmVzcyEifQ

Guidance for agents: always show the user the link and tell them to review amounts, dates, and tax before downloading. Do not present the invoice as final — the user completes it in the editor.

## Docs

- Human-readable prefill/link documentation: https://invoiceko.com/docs
- Invoice JSON Schema: https://invoiceko.com/schema/invoice.json

## Roadmap for agents

A REST API (`POST /api/v1/invoices` returning a PDF) and an MCP server are planned. The prefill link above is the supported integration today.